• 文档首页

未读数

注意事项

1. 会话未读数指某一个会话中未读消息的数量
2. 未读消息数也可通过 conversation.unreadMessageCount 获取
3. 会话消息未读数存储在 WebStorage 中, 若浏览器不支持或禁用 WebStorage，未读消息数将不会保存，浏览器页面刷新未读消息数将不会存在

清除指定会话未读数

参数说明:

参数	类型	必填	说明	最低版本
conversationType	Number	是	会话类型	2.2.0
targetId	String	是	目标 id	2.2.0
callback	Object	是	回调对象	2.2.0

代码示例:

var conversationType = RongIMLib.ConversationType.PRIVATE;
var targetId = 'user1';
RongIMClient.getInstance().clearUnreadCount(conversationType, targetId, {
  onSuccess: function() {
    console.log('清除指定会话未读消息数成功');
  },
  onError: function(error) {
    console.log('清除指定会话未读消息数失败', error);
  }
});

获取所有会话未读数

代码示例:

RongIMClient.getInstance().getTotalUnreadCount({
  onSuccess: function(count) {
    console.log('获取所有会话未读消息数成功', count);
  },
  onError: function(error) {
    console.log('获取所有会话未读消息数失败', error);
  }
});

获取指定会话未读数

参数说明:

参数	类型	必填	说明	最低版本
conversationType	Number	是	会话类型	2.2.0
targetId	String	是	目标 id	2.2.0
callback	Object	是	回调对象	2.2.0

代码示例:

var conversationType = RongIMLib.ConversationType.PRIVATE;
var targetId = 'user1';
RongIMLib.RongIMClient.getInstance().getUnreadCount(conversationType, targetId, {
  onSuccess: function(count) {
    console.log('获取指定会话未读消息数成功', count);
  },
  onError: function(error) {
    console.log('获取指定会话未读消息数失败', error);
  }
});

获取指定会话类型总未读数

参数说明:

参数	类型	必填	说明	最低版本
conversationTypes	Array	是	指定会话类型	2.2.0
callback	Object	是	回调对象	2.2.0

代码示例:

var conversationTypes = [RongIMLib.ConversationType.PRIVATE, RongIMLib.ConversationType.DISCUSSION];
RongIMClient.getInstance().getConversationUnreadCount(conversationTypes, {
  onSuccess: function(count) {
    console.log('获取指定会话类型总未读消息数成功', count);
  },
  onError: function(error) {
    console.log('获取指定会话类型总未读消息数失败', error);
  }
});