会话未读数

即时通讯客户端常常需要对会话进行未读消息计数。

您可以使用 IMLib SDK 提供的接口直接获取会话中的未读消息数。具体能力如下：

• 获取所有会话（不含聊天室）中的未读消息总数（getTotalUnreadCount）
• 获取指定会话中的总未读消息数，或指定会话中指定消息类型的总未读消息数，或按会话类型获取总未读消息总数（getUnreadCount）

在用户使用您的 App 时，UI 上未读计数可能需要发生变化，此时您可以清除会话中的未读数（clearUnreadCount）。

获取所有会话未读数

获取所有会话类型(除聊天室外)的未读数。

方法

TypeScript

getTotalUnreadCount(
  channelId: string, 
  callback: IRCIMIWGetTotalUnreadCountCallback
): Promise<number>;

参数说明

参数名	参数类型	描述
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
callback	IRCIMIWGetTotalUnreadCountCallback	接口调用结果回调。

返回值

返回值	描述
number	当次接口操作的状态码。0 代表接口调用成功，具体业务结果需要从接口回调获取，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例

TypeScript

const callback = {
    onSuccess: (t: number) => {
        //...
    },
    onError: (code: number) => {
        //...
    },
};
let code = await engine.getTotalUnreadCount(channelId, callback);

获取指定会话未读数

获取指定会话(除聊天室外)的所有未读消息个数。

方法

TypeScript

getUnreadCount(
  type: RCIMIWConversationType, 
  targetId: string, 
  channelId: string, 
  callback: IRCIMIWGetUnreadCountCallback
): Promise<number>;

参数说明

参数名	参数类型	描述
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
callback	IRCIMIWGetUnreadCountCallback	接口调用结果回调。

返回值

返回值	描述
number	当次接口操作的状态码。0 代表接口调用成功，具体业务结果需要从接口回调获取，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例

TypeScript

const callback = {
    onSuccess: (t: number) => {
        //...
    },
    onError: (code: number) => {
        //...
    },
};
let code = await engine.getUnreadCount(type, targetId, channelId, callback);

按会话类型获取未读数

获取多个指定会话类型(除聊天室外)的未读数。

方法

TypeScript

getUnreadCountByConversationTypes(
  conversationTypes: Array<RCIMIWConversationType>, 
  channelId: string, 
  contain: boolean, 
  callback: IRCIMIWGetUnreadCountByConversationTypesCallback
): Promise<number>;

参数说明

参数名	参数类型	描述
conversationTypes	Array<RCIMIWConversationType>	会话类型集合
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
contain	boolean	是否包含免打扰消息的未读消息数。
callback	IRCIMIWGetUnreadCountByConversationTypesCallback	接口调用结果回调。

返回值

返回值	描述
number	当次接口操作的状态码。0 代表接口调用成功，具体业务结果需要从接口回调获取，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例

TypeScript

const callback = {
    onSuccess: (t: number) => {
        //...
    },
    onError: (code: number) => {
        //...
    },
};
let code = await engine.getUnreadCountByConversationTypes(conversationTypes, channelId, contain, callback);

清除指定会话未读数

清除指定会话(除聊天室外)的未读数。

方法

TypeScript

clearUnreadCount(
  type: RCIMIWConversationType, 
  targetId: string, 
  channelId: string, 
  timestamp: number, 
  callback: IRCIMIWClearUnreadCountCallback
): Promise<number>;

参数说明

参数名	参数类型	描述
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
timestamp	number	该会话已阅读的最后一条消息的发送时间戳，清除所有传入当前最新时间戳
callback	IRCIMIWClearUnreadCountCallback	接口调用结果回调。

返回值

返回值	描述
number	当次接口操作的状态码。0 代表接口调用成功，具体业务结果需要从接口回调获取，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例

TypeScript

const callback = {
    onUnreadCountCleared: (code: number) => {
        //...
    },
};
let code = await engine.clearUnreadCount(type, targetId, channelId, timestamp, callback);

加载所有@未读数

加载某个会话的所有@未读数

方法

TypeScript

getUnreadMentionedCount(
  type: RCIMIWConversationType, 
  targetId: string, 
  channelId: string, 
  callback: IRCIMIWGetUnreadMentionedCountCallback
): Promise<number>;

参数说明

参数名	参数类型	描述
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
callback	IRCIMIWGetUnreadMentionedCountCallback	接口调用结果回调。

返回值

返回值	描述
number	当次接口操作的状态码。0 代表接口调用成功，具体业务结果需要从接口回调获取，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考错误码

代码示例

TypeScript

const callback = {
    onSuccess: (t: number) => {
        //...
    },
    onError: (code: number) => {
        //...
    },
};
let code = await engine.getUnreadMentionedCount(type, targetId, channelId, callback);