如果您的应用 UI 上需要展示频道未读数，可参考本文介绍的方法/事件获取频道内的消息未读信息并管理其变化。

游客接收到的消息无已读未读逻辑。不支持对游客展示消息未读数。

未读信息定义

NIM SDK 中的QChatUnreadInfo类定义了圈组频道的未读信息，其成员参数如下：

单击展开查看 QChatUnreadInfo 的成员参数

参数	类型	说明
serverId	int	频道所属的服务器的 ID
channelId	string	频道的 ID
unreadCount	number	频道内的消息未读数
mentionedCount	number	频道内@消息的未读数
maxCount	int	最大消息未读数
time	int	服务器当前时间
ackTimeTag	int	已读时间戳（Unix 时间戳）， 该时间戳对应的消息和早于该时间戳的消息都为已读消息
lastMsgTime	int	（可选）最后一条消息的时间戳 （Unix 时间戳）

您可通过多个方式获取QChatUnreadInfo，具体方法参见本文的实现频道未读数持续监听和实现频道未读数的直接获取。

前提条件

• 已注册onUnreadInfoChanged事件流，监听未读信息变化事件（QChatUnreadInfoChangedEvent），该事件信息中包含未读信息QChatUnreadInfo。
• 已在频道内发送消息。

实现流程

实现频道未读数持续监听

本文通过以下 UI 简图的场景为例，说明如何完成频道 1 未读数的监听、未读数的清零以及清零后的持续监听。

步骤1: 监听未读数

您需要订阅 频道 1 的未读数才能实现监听。完成如下两个子步骤后，当有新的消息下发到频道 1 ，SDK 将触发未读数变化监听事件（QChatUnreadInfoChangedEvent）并上报。

订阅的频道仅在当前登录期间有效（因网络波动导致的断线自动重连除外）。如果用户调用QChatservice.logout 登出，需要重新订阅。

1. 进入服务器 1 后，调用getChannelsByPage方法刷新频道列表，得到频道 1、频道 2、频道 3 和 频道 4。

2. 调用subscribeChannel方法订阅频道 1。 调用该方法时入参配置如下：

   参数	说明
   channelIdInfos	频道 ID：传入您需要订阅的频道 ID，以及该频道所属的服务器的 ID。格式为{ channelId: string; serverId: string }[]。
   operateType	操作类型： sub：订阅 unsub：取消订阅
   type	订阅类型，具体类型见QChatSubscribeType，本场景下需传入channelMsgUnreadCount订阅频道的未读数。

   示例代码如下：

   QChatChannel? channel1;
   
    var paramChannels = QChatGetChannelsByPageParam(serverId: serverId, timeTag: timeTag, limit: 100);
    NimCore.instance.qChatChannelService.getChannelsByPage(paramChannels).then((value){
      if(value.isSuccess){
        //todo  保存channel info
        channel1 = value.data?.channels?.first;
      }else{
   
      }
    });
   
    if(channel1 != null){
      var channelIdInfos = [
        QChatChannelIdInfo(serverId: serverId, channelId: channel1!.channelId)
      ];
      var paramSubChannel = QChatSubscribeChannelParam(type: QChatSubscribeType.channelMsgUnreadCount, operateType: QChatSubscribeOperateType.sub, channelIdInfos: channelIdInfos);
      NimCore.instance.qChatChannelService.subscribeChannel(paramSubChannel).then((value){
        if(value.isSuccess){
          //todo  success
        }else{
   
        }
      });
    }
   

步骤2：清除未读数

以下说明以清除频道 1 的未读数为例，介绍在完成步骤1: 监听未读数后，如何清除频道未读数以及清除后对未读数进行持续监听。

1. 进入频道 1 后，记住您应用中“代表该频道的属性”（假设为currentChannel）。

2. 调用markMessageRead方法，调用时传time参数为已读的最新消息的时间戳（Unix 时间戳），进行未读数的清零操作。

   未读数清零时，SDK 触发QChatUnreadInfoChangedEvent事件，该事件包含的未读数参数unreadCount 为0。

   • 针对同一个频道（channelId），调用 markMessageRead 方法存在频控限制，300 ms 内只能调用一次。
   • 如果调用markMessageRead时传ackTimestamp参数为0，会将频道内所有消息标记为未读。
   
   

   示例代码如下：

   var paramRead = QChatMarkMessageReadParam(serverId: serverId, channelId: channelId, ackTimestamp: ackTimestamp);
   NimCore.instance.qChatMessageService.markMessageRead(paramRead).then((value){
     if(value.isSuccess){
       //todo  success
     }else{
   
     }
   });
   

3. 根据您的应用逻辑做出判断和处理：当currentChannel与QChatUnreadInfoChangedEvent事件里的channelId相同时，每当频道 1 有新消息接收时，仍旧会触发QChatUnreadInfoChangedEvent事件。

实现频道未读数的直接获取

如果您不想订阅某个频道，而只想获取该频道当前的未读数，完成以下操作即可。

1. 确保您已在当前频道中。

2. 直接调用getChannelUnreadInfos查询当前频道未读信息。

   该方法单次最多查询频道数量为 100。

   
   

   示例代码：

   var channelIdInfos = [
     QChatChannelIdInfo(serverId: serverId, channelId: channelId)
   ];
   var paramUnread = QChatGetChannelUnreadInfosParam(channelIdInfos);
   NimCore.instance.qChatChannelService.getChannelUnreadInfos(paramUnread).then((value){
     if(value.isSuccess){
       //todo  success
     }else{
   
     }
   });
   

常见问题

1. 什么操作会导致频道未读数增加？

您当前所在的频道中，有用户通过sendMessage发送消息或通过updateMessage更新消息，对应频道中的当前用户未读信息中的未读数会增加。以下特殊情情况除外：

• 消息发送者是自己
• 不存云端消息历史
• 不需要消息计数
• 未订阅当前频道

2. 什么操作会导致频道未读数减少？

您当前所在的频道中，有用户通过deleteMessage删除消息，对应频道中的当前用户未读信息中的未读数会减少。以下特殊情况除外：

• 删除的是自己发的消息，则未读数不变。
• 未订阅当前频道。

3. 撤回消息和重发消息是否影响未读数？

这两种操作都不影响未读数。

4. 通过markMessageRead方法标记频道消息已读，对未读数有什么影响？

如果在当前频道通过markMessageRead标记消息已读，会更新对应频道的未读信息。

调用该方法时传入ackTimestamp参数（标记消息已读的时间戳），不仅可能减少未读数，还可能增加未读数。例如将ackTimestamp设为0时，会标记所有消息未读从而增加未读数。