跳到主要内容

消息未读数

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

提示

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

(width=250)

用法

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)中显示未读消息气泡提醒。

(width=250)