跳到主要内容

版本:5.X

多端同步已读状态

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

同步消息已读状态

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

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

RongIMLib.clearMessagesUnreadStatus({
conversationType,
targetId,
channelId,
}).then((res) => {
if (res.code === 0) {
console.log(res.code)
} else {
console.log(res.code, res.msg)
}
})
参数类型必填说明
targetIdString超级群 ID
conversationTypeNumberRongIMLib.ConversationType.ULTRA_GROUP。会话类型,参考 ConversationType
channelIdString超级群频道 ID