跳到主要内容

多端同步已读状态

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

同步消息已读状态​

客户端主动调用 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
conversationTypeNumber是RongIMLib.ConversationType.ULTRA_GROUP。会话类型，参考 ConversationType。
channelIdString否超级群频道 ID
最后于 更新