浏览 SDKs · uni-app / uni-app x
平台
SDKsuni-app / uni-app x

设置会话扩展字段

设置当前用户指定会话的业务扩展字符串。

复制

ex 用于保存应用自定义的会话级数据。它是完整字符串,SDK 不会自动合并 JSON;多个业务模块共用时,应划分稳定命名空间,并在写入前保留其他模块的数据。

import { setConversation } from '@/uni_modules/unix-openim-sdk'

await setConversation({
  conversationID,
  ex: JSON.stringify({ category: 'work' }),
})

示例展示一次完整写入。实际项目如果已经保存其他扩展数据,应先按业务约定解析旧值、合并所需字段,再序列化整个新值。

Promise 成功表示设置请求已完成。客户端可先将本地对应会话的 ex 字段更新为目标值,收到会话变更事件后,按 conversationID 确认最新状态;需要校准状态时可重新拉取该会话。完整会话事件监听见获取会话列表。