会话未读数

你可以查看本地所有会话或指定会话的未读消息数，并针对会话的未读消息数清零。

前提条件

开始前，请确保满足以下条件：

• 完成 SDK 初始化并连接到服务器，详见 快速开始。
• 了解即时通讯 IM 的使用限制，详见 使用限制。

技术原理

即时通讯 IM Flutter SDK 通过 ChatManager 和 ChatConversation 类实现对本地会话的未读消息数的管理，其中核心方法如下：

• ChatManager#getUnreadMessageCount：获取本地所有会话的未读消息数。
• ChatConversation#unreadCount：获取本地指定会话的未读消息数。
• ChatManager#markAllConversationsAsRead：将本地所有会话的未读消息数清零。
• ChatConversation#markAllMessagesAsRead：对于本地指定会话的未读消息数清零。
• ChatConversation#markMessageAsRead：将指定会话的单条未读消息置为已读。

实现方法

获取所有会话的未读消息数

你可以调用 getUnreadMessageCount 方法获取本地所有会话的未读消息数量，示例代码如下：

int unreadCount =
        await ChatClient.getInstance.chatManager.getUnreadMessageCount();

获取指定会话的未读消息数

你可以调用 unreadCount 方法获取本地指定会话的未读消息数，示例代码如下：

int unreadCount = await conversation.unreadCount();

将所有会话的未读消息数清零

你可以调用 markAllConversationsAsRead 方法将本地所有会话设为已读，即将所有会话的未读消息数清零，示例代码如下：

await ChatClient.getInstance.chatManager.markAllConversationsAsRead();

指定会话的未读消息数清零

你可以调用 markAllMessagesAsRead 方法对指定会话的未读消息数清零，示例代码如下：

await conversation.markAllMessagesAsRead();

将指定会话的单条未读消息置为已读

你可以调用 markMessageAsRead 方法将指定会话的单条未读消息置为已读。

await conversation.markMessageAsRead(message.msgId);