会话未读数

获取所有会话未读数

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

方法

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

参数说明

参数名	参数类型	描述
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
callback	IRCIMIWGetTotalUnreadCountCallback	获取所有未读数事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数，仅触发 callback 回调。

返回值

返回值	描述
Promise<number>	当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考状态码文档。

代码示例

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

回调方法

• setOnTotalUnreadCountLoadedListener

setOnTotalUnreadCountLoadedListener(listener?: ({code, channelId, count}) => void): void;

参数说明

参数名	参数类型	描述
code	number	接口回调的状态码，0 代表成功，非 0 代表出现异常
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
count	number	未读数量

代码示例

engine.setOnTotalUnreadCountLoadedListener((res) => {
    //...
});

获取指定会话未读数

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

方法

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

参数说明

参数名	参数类型	描述
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
callback	IRCIMIWGetUnreadCountCallback	获取会话未读数事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数，仅触发 callback 回调。

返回值

返回值	描述
Promise<number>	当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考状态码文档。

代码示例

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

回调方法

• setOnUnreadCountLoadedListener

setOnUnreadCountLoadedListener(listener?: ({code, type, targetId, channelId, count}) => void): void;

参数说明

参数名	参数类型	描述
code	number	接口回调的状态码，0 代表成功，非 0 代表出现异常
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
count	number	未读数量

代码示例

engine.setOnUnreadCountLoadedListener((res) => {
    //...
});

按会话类型获取未读数

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

方法

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

参数说明

参数名	参数类型	描述
conversationTypes	Array<RCIMIWConversationType>	会话类型集合
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
contain	boolean	是否包含免打扰消息的未读消息数。
callback	IRCIMIWGetUnreadCountByConversationTypesCallback	事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数，仅触发 callback 回调。

返回值

返回值	描述
Promise<number>	当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考状态码文档。

代码示例

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

回调方法

• setOnUnreadCountByConversationTypesLoadedListener

setOnUnreadCountByConversationTypesLoadedListener(listener?: ({code, conversationTypes, channelId, contain, count}) => void): void;

参数说明

参数名	参数类型	描述
code	number	接口回调的状态码，0 代表成功，非 0 代表出现异常
conversationTypes	Array<RCIMIWConversationType>	会话类型集合
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
contain	boolean	是否包含免打扰消息的未读消息数。
count	number	未读数量

代码示例

engine.setOnUnreadCountByConversationTypesLoadedListener((res) => {
    //...
});

清除指定会话未读数

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

方法

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	事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数，仅触发 callback 回调。

返回值

返回值	描述
Promise<number>	当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调，非 0 代表当前接口调用操作失败，不会触发接口回调，详细错误参考状态码文档。

代码示例

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

回调方法

• setOnUnreadCountClearedListener

setOnUnreadCountClearedListener(listener?: ({code, type, targetId, channelId, timestamp}) => void): void;

参数说明

参数名	参数类型	描述
code	number	接口回调的状态码，0 代表成功，非 0 代表出现异常
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
timestamp	number	该会话已阅读的最后一条消息的发送时间戳

代码示例

engine.setOnUnreadCountClearedListener((res) => {
    //...
});

加载所有@未读数

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

方法

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

参数说明

参数名	参数类型	描述
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
callback	IRCIMIWGetUnreadMentionedCountCallback	获取会话中未读的 @ 消息数量事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数，仅触发 callback 回调。

代码示例

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

回调方法

• setOnUnreadMentionedCountLoadedListener

setOnUnreadMentionedCountLoadedListener(listener?: ({code, type, targetId, channelId, count}) => void): void;

参数说明

参数名	参数类型	描述
code	number	接口回调的状态码，0 代表成功，非 0 代表出现异常
type	RCIMIWConversationType	会话类型
targetId	string	会话 ID
channelId	string	频道 ID，仅支持超级群使用，其他会话类型传 null 即可。
count	number	未读数量

代码示例

engine.setOnUnreadMentionedCountLoadedListener((res) => {
    //...
});