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

设置消息本地扩展

更新一条消息在当前设备的 localEx。

复制

localEx 只保存在当前客户端,适合折叠、选中或本地来源标记,不会同步给其他用户或设备。

参数说明

参数类型是否必填说明
conversationIDstring目标消息所在的会话 ID。
clientMsgIDstring目标消息 ID。
localExstring要写入的完整字符串。
import { setMessageLocalEx } from '@/uni_modules/unix-openim-sdk'

await setMessageLocalEx({
  conversationID,
  clientMsgID,
  localEx: JSON.stringify({ selected: true }),
})

Promise 成功表示本地数据已更新。该方法不会自动合并旧 JSON,也不会触发共享消息事件;需要保留旧字段时先在业务层合并,并限制大小。不要在 localEx 中存放 Token 或不可恢复的重要业务数据。