跳到主要内容

会话未读数

获取所有会话未读数

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

方法

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

参数说明

参数名参数类型描述
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
callbackIRCIMIWGetTotalUnreadCountCallback获取所有未读数事件回调。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;

参数说明

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

代码示例

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

获取指定会话未读数

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

方法

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

参数说明

参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
callbackIRCIMIWGetUnreadCountCallback获取会话未读数事件回调。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;

参数说明

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

代码示例

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

按会话类型获取未读数

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

方法

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

参数说明

参数名参数类型描述
conversationTypesArray<RCIMIWConversationType>会话类型集合
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
containboolean是否包含免打扰消息的未读消息数。
callbackIRCIMIWGetUnreadCountByConversationTypesCallback事件回调。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;

参数说明

参数名参数类型描述
codenumber接口回调的状态码,0 代表成功,非 0 代表出现异常
conversationTypesArray<RCIMIWConversationType>会话类型集合
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
containboolean是否包含免打扰消息的未读消息数。
countnumber未读数量

代码示例

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

清除指定会话未读数

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

方法

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

参数说明

参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
timestampnumber该会话已阅读的最后一条消息的发送时间戳,清除所有传入当前最新时间戳
callbackIRCIMIWClearUnreadCountCallback事件回调。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;

参数说明

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

代码示例

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

加载所有@未读数

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

方法

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

参数说明

参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
callbackIRCIMIWGetUnreadMentionedCountCallback获取会话中未读的 @ 消息数量事件回调。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;

参数说明

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

代码示例

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