消息未读数

未读消息计数是 Global IM UIKit 默认提供的一项功能，可告知用户每个会话中未读消息的数量。未读消息计数显示在会话列表类 RCChatListViewController 的 RCChatCell 中。每个会话的未读消息数显示在会话图标右上角。如果未读消息数超过 100 条，则会显示为 99+ 。

提示

为了使用未读消息计数功能，您必须首先构建会话列表页面。Global IM UIKit 默认未实现在 Tab Bar 中显示未读消息数。如有需要您可以参考 SealTalk 项目（GitHub · Gitee）中的实现。

用法

Global IM UIKit 默认已经实现了一整套会话未读消息数的获取和展示逻辑，使用默认会话列表和会话页面时，不需要额外调用会话相关 API。

Global IM UIKit 会在用户进入单聊、群聊、系统会话页面时将会话未读数清零。在用户多端登录时，Global IM UIKit 会在设备间同步会话的阅读状态，您也可以按业务需求选择关闭该功能，详见下文多端同步阅读状态。

定制化

如果 Global IM UIKit 已有实现无法满足您的需求，可以使用 Global IM UIKit 或 IMLib SDK 中相关 API。

清除会话未读数

Global IM UIKit 未直接提供获取、清除会话未读数的 API。如果您有自定义需求，可以调用 IMLib SDK 相关方法。例如：

• 获取所有会话未读数
• 按会话类型获取未读数
• 清除单个会话未读数

具体的核心类、API 与 使用方法，详见 IMLib 文档 处理会话未读消息数。

提示

IMLib 中的方法并不提供页面刷新能力，您需要根据业务需求自定义通知机制进行页面刷新。

未读消息气泡提醒

Global IM UIKit 支持在会话页面（RCChatViewController）中显示未读消息气泡提醒。