onConversationListUpdate 事件载荷。items 始终是 SDK 当前完整且已排序的 ConversationItem 快照;patch 用于业务按增量合并并保留自定义本地字段。

interface ConversationListUpdatePayload {
    version: number;
    items: readonly ConversationItem[];
    reason: ConversationListUpdateReason;
    patch: ConversationListUpdatePatch;
}

Properties

version: number

会话列表快照版本号,每次有效派发递增,可用于忽略旧事件。

items: readonly ConversationItem[]

当前完整且已排序的会话列表快照。简单 UI 推荐直接用该字段刷新列表。

本次列表更新原因。

本次变化补丁,便于业务保留本地字段。