浏览 SDKs · WASM
平台
SDKsWASM

设置消息本地扩展

使用 WASM SDK 更新当前客户端的消息本地扩展字段。

复制

字段 localEx 仅保存在当前设备本地,常用于记录消息气泡的本地展开/折叠状态、多选标记或播放进度等前端交互数据,不会同步给对端或其他登录设备。

参数说明

参数类型是否必填说明
conversationIDstring是目标消息所在的会话 ID。
clientMsgIDstring是目标消息 ID。
localExstring是要写入的完整字符串。
await openimsdk.setMessageLocalEx({
  conversationID,
  clientMsgID,
  localEx: JSON.stringify({ selected: true }),
});

接口调用成功后,本地存储中的 localEx 即更新完毕。需要注意:localEx 为纯字符串,SDK 不会自动进行 JSON 合并;若存储多项自定义属性,请先在业务层合并后再整体写入。该操作属于本地存储更新,不会触发远端消息事件。