消息未读数
未读消息计数是 IMKit 默认提供的一项功能,可告知用户每个会话中未读消息的数量。未读消息计数显示在会话列表类 RCConversationListViewController
的 RCConversationCell
中。每个会话的未读消息数显示在会话图标右上角。如果未读消息数超过 100 条,则会显示为 99+
。
用法
IMKit SDK 默认已经实现了一整套会话未读消息数的获取和展示逻辑,使用默认会话列表和会话页面时,不需要额外调用会话相关 API。
IMKit 会在用户进 入单聊、群聊、系统会话页面时将会话未读数清零。在用户多端登录时,IMKit 会在设备间同步会话的阅读状态,您也可以按业务需求选择关闭该功能,详见下文多端同步阅读状态。
定制化
如果 IMKit 已有实现无法满足您的需求,可以使用 IMKit 或 IMLib SDK 中相关 API。
获取或清除会话未读数
IMKit 未直接提供获取、清除会话未读数的 API。如果您有自定义需求,可以调用 IMLib SDK 相关方法。例如:
- 获取所有会话未读数
- 按会话类型获取未读数
- 清除单个会话未读数
具体的核心类、API 与 使用方法,详见 IMLib 文档 处理会话未读消息数。
IMLib 中的方法并不提供页面刷新能力,您需要根据业务需求自定义通知机制进行页面刷新。
设置为仅显示红点
如果希望仅在会话列表中的 RCConversationCell
上显示红点,而不显示具体数字,您可以重写 RCConversationListViewController
的willDisplayConversationTableCell:atIndexPath:
方法,设置 isShowNotificationNumber
属性值为 NO
。
- (void)willDisplayConversationTableCell:(RCConversationBaseCell *)cell atIndexPath:(NSIndexPath *)indexPath {
//会话有新消息通知的时候显示数字提醒,设置为NO,不显示数字只显示红点
((RCConversationCell *)cell).isShowNotificationNumber = NO;
}
自定义未读消息角标 UI
会话列表中的 RCConversationCell
上的未读消息角标 UI 由 RCConversationListViewController
的 bubbleTipView
属性控制。您可以重写 RCConversationListViewController
的willDisplayConversationTableCell:atIndexPath:
方法修改。
下表仅列出了 bubbleTipView
中的部分属性。完整属性列表请参见 API 文档中的 RCMessageBubbleTipView。
项目 | 属性 | 类型 | 默认值 |
---|---|---|---|
角标位置 | bubbleTipAlignment | RCMessageBubbleTipViewAlignment | RC_MESSAGE_BUBBLE_TIP_VIEW_ALIGNMENT_TOP_RIGHT |
角标文本颜色 | bubbleTipTextColor | UIColor | whiteColor |
角标背景颜色 | bubbleTipBackgroundColor | UIColor | redColor |
修改已读未读状态图标为文本
SDK 会话页面中文本消息已读的 UI 默认是一个“对勾”图标,如果希望修改为「已读」或「未读」,可以在 Cell 显示的时候,将 SDK 默认的图标 移除。
修改步骤详见会话页面文档中的自定义消息 Cell 显示。
多端同步阅读状态
如果 SDK 版本 ≦ 5.6.2,不支持多端同步系统会话的已读、未读状态。
在即时通讯业务中,同一用户账号可能在多个设备上登录。仅在开通多设备消息同步服务后,融云会在多个设备之间同步消息数据,但设备上的会话中消息的已读/未读状态仅存储在本地。
IMKit SDK 已默认实现了会话多端阅读状态同步功能,在一端发起同步后,其他端可接收通知,按要求同步阅读状态。您可以按业务需求决定是否使用该功能,该功能默认开启。
RCKitConfigCenter.message.enableSyncReadStatus = YES;
未读消息气泡提醒
IMKit 支持在会话页面(RCConversationViewController
)中显示未读消息气泡提醒。