跳到主要内容

版本:2.X

会话置顶

设置置顶

API 参考:setConversationStatus

参数说明

参数类型必填说明最低版本
conversationTypeNumber会话类型,单聊会话传入 RongIMLib.ConversationType.PRIVATE2.5.8
targetIdString单聊会话 ID2.5.8
statusItemObject设置对象2.5.8
statusItem.isTopBoolean是否置顶2.5.8
statusItem.notificationStatusNumber是否免打扰: 1 开启免打扰 | 2 关闭免打扰2.5.8
callbackObject回调对象2.5.8
callback.onSuccessFunction成功回调2.5.8
callback.onErrorFunction失败回调2.5.8

代码示例

var conversationType = RongIMLib.ConversationType.PRIVATE;
var targetId = '接收方的 userId';
var statusItem = {
isTop: true
};
RongIMClient.getInstance().setConversationStatus(conversationType, targetId, statusItem, {
onSuccess: function() {
console.log('设置会话状态成功')
},
onError: function(error) {
console.log('设置会话状态失败', error)
}
})

低版本实现

危险

SDK 2.5.8 版本以下可使用如下方法设置

设置置顶

Web SDK 没有本地数据库,不提供 设置会话置顶 接口。如需要实现 会话置顶 功能可参照如下解决方案。

会话置顶、消息免打扰实现思路:

  1. 把置顶、免打扰的会话存在自己的服务器,当前用户 + conversationType + targetId 可以确定一个唯一的会话。
  2. 渲染会话列表前先自己的服务器获取置顶、免打扰的会话,与 getConversationList 返回的会话列表通过比对 conversationType + targetId 进行合并。
  3. 群组信息、用户信息需要在自己的服务器。

取消置顶

如您需要实现 取消会话置顶 功能可根据您 设置会话置顶 功能的实现对应实现取消会话置顶。