跳到主要内容
版本：5.X

多端同步已读状态

超级群业务可在多个客户端之间同步消息阅读状态。

同步消息已读状态​

客户端主动调用 clearMessagesUnreadStatus 清除未读数时，SDK 会同时清除本地与服务端记录的消息的未读状态，同时服务端会将最新状态同步给同一用户账号的其他客户端。

  • 如果指定了频道 ID（channelId），则标记该频道所有消息为全部已读，并同步其他客户端。
  • 如果频道 ID 为空，则标记该超级群会话下所有不属于任何频道的消息为全部已读，并同步其他客户端。
提示
  • 超级群暂不支持按时间戳同步已读状态。调用 clearMessagesUnreadStatus 会按指定参数的要求标记全部消息为已读。
  • 超级群的多端未读数同步由融云服务端维护，Web 客户端不需要发送 RC:SRSMsg 消息来进行多端未读数同步。
  • 在多端同步消息已读状态时，可通过 Events.CONVERSATION 监听消息已读状态。参见快速上手中的「设置监听」。

接口​

JavaScript
RongIMLib.clearMessagesUnreadStatus(conversation)

参数说明​

参数类型必填说明
conversationIConversationOption是目标会话

示例代码​

JavaScript
const conversation = {
  conversationType: RongIMLib.ConversationType.ULTRA_GROUP
  targetId: '超级群 ID'
  channelId: '超级群频道 ID'
}

RongIMLib.clearMessagesUnreadStatus(conversation).then((res) => {
  if (res.code === 0) {
    console.log(res.code)
  } else {
    console.log(res.code, res.msg)
  }
})
最后于 更新