跳到主要内容

获取未读消息数

超级群业务支持从客户端 SDK 获取未读消息数,具体如下:

  • 当前用户加入的所有超级群、指定超级群、或指定频道的未读消息数。
  • 当前用户加入的所有超级群、指定超级群、或指定频道的未读 @ 消息数。
  • 按免打扰级别获取总未读消息数

返回的未读数最大值为 999。如果实际未读数超过 999,接口仍返回 999。

获取多个超级群的未读消息数

SDK 支持获取当前用户加入的所有超级群中未读消息数与未读 @ 消息数。

批量获取当前用户的超级群的未读消息数

提示

SDK 从 5.4.6 版本开始支持该接口。仅在 ChannelClient 中提供。

在社群应用场景中,App 可能需要实时显示用户所在的多个超级群下所有频道的最新未读消息数据,可以使用 getUltraGroupConversationUnreadInfoList 一次获取最多 20 个超级群下所有频道的未读数据。具体包含:

  • 超级群频道的未读消息数
  • 超级群频道的未读 @ 消息数
  • 超级群频道中仅 @ 当前用户的未读 @ 消息数
  • 超级群频道的免打扰级别
[[RCChannelClient sharedChannelManager] getUltraGroupConversationUnreadInfoList:targetIds success:^(NSArray<RCConversationUnreadInfo *> * _Nonnull list) {
for (RCConversationUnreadInfo *info in list) {
NSString *content = [NSString stringWithFormat:@"%@ %@:%@,%@,%@,%@", info.targetId, info.channelId, @(info.unreadMessageCount), @(info.mentionedCount), @(info.mentionedMeCount), @(info.notificationLevel)];
NSLog(@"%@", content);
}
} error:^(RCErrorCode status) {
// TODO error code
}];

获取当前用户的超级群未读消息数总和

获取当前用户加入的所有超级群会话的未读消息数的总和。

- (void)getUltraGroupAllUnreadCount:(void (^)(NSInteger count))successBlock
error:(void (^)(RCErrorCode status))errorBlock;

获取当前用户的超级群未读 @ 消息数总和

获取当前用户加入的所有超级群会话中的未读 @ 消息数的总和。

- (void)getUltraGroupAllUnreadMentionedCount:(void (^)(NSInteger  count))successBlock
error:(void (^)(RCErrorCode status))errorBlock;

获取单个超级群的未读消息数

SDK 支持获取指定超级群或频道中的未读消息数和未读 @ 消息数。

获取指定单个超级群的未读消息数

获取当前用户在指定超级群中的未读消息数。

- (void)getUltraGroupUnreadCount:(NSString *)targetId
success:(void (^)(NSInteger count))successBlock
error:(void (^)(RCErrorCode status))errorBlock

获取指定单个超级群的未读 @ 消息数

获取当前用户在指定超级群中的未读 @ 消息数。

- (int)getUltraGroupUnreadMentionedCount:(NSString *)targetId

获取指定频道的未读消息数

获取当前用户在超级群会话指定的频道中的未读消息数。

- (int)getUnreadCount:(RCConversationType)conversationType targetId:(NSString *)targetId channelId:(NSString *)channelId;

获取指定频道的未读 @ 消息数

App 可以直接从 RCConversation 对象上获取该频道未读 @ 消息数。

  • mentionedCount:当前频道中 “@所有人”与“@当前用户”的未读消息数之和。
  • mentionedMeCount:当前频道中 “@当前用户”的未读消息数。要求 SDK 版本 ≧ 5.4.5。

具体示例可参见获取频道列表

按免打扰级别获取超级群的总未读消息数

提示

SDK 从 5.2.5 版本开始支持该接口。仅在 RCChannelClient 中提供。

获取已设置指定免打扰级别的会话及频道的总未读消息数。SDK 将按照传入的免打扰级别配置查找,再返回该会话下符合设置的频道的总未读消息数。

NSArray * pushNotificationLevels = @[@(RCPushNotificationLevelMention)];
[[RCChannelClient sharedChannelManager] getUltraGroupUnreadCount:targetId
levels: pushNotificationLevels
success:^(NSInteger unReadCount) {}
error:^(RCErrorCode status) {}];

获取成功后,successBlock 中会返回未读消息数。

参数类型必填
targetIdNSString会话 ID
levelsRCPushNotificationLevel[]免打扰类型数组。详见免打扰功能概述
successBlockBlock成功回调
errorBlockBlock失败回调

按免打扰级别获取超级群的总未读 @ 消息数

提示

SDK 从 5.2.5 版本开始支持该接口。仅在 RCChannelClient 中提供。

获取已设置指定免打扰级别的会话及频道的总未读 @ 消息数。SDK 将按照传入的免打扰级别配置查找,再返回该会话下符合设置的频道的总未读 @ 消息数。

NSArray * pushNotificationLevels = @[@(RCPushNotificationLevelMention)];
[[RCChannelClient sharedChannelManager] getUltraGroupUnreadMentionedCount:targetId
levels: pushNotificationLevels
success:^(NSInteger unReadCount) {}
error:^(RCErrorCode status) {}];

获取成功后,successBlock 中会返回未读消息数。

参数类型必填
targetIdNSString会话 ID
levelsRCPushNotificationLevel[]免打扰类型数组。详见免打扰功能概述
successBlockBlock成功回调
errorBlockBlock失败回调

如果您希望获取多个类型会话的未读消息总数,可参见处理会话未读消息数中介绍的方法。