频道未读数管理

更新时间: 2023/07/21 06:56:54

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

技术原理

网易云信 IM SDK 的 QCHAT_BROWSER_SDK 下的QChatChannelServiceInterface 模块提供 UnreadInfo 属性,该属性内包含未读信息相关参数,具体见下表。

参数 类型 说明
serverId string 频道所属的服务器的 ID

您可调用多个方法获取该属性,具体方法参见本文的实现频道未读数持续监听实现频道未读数的直接获取

前提条件

已完成圈组初始化及登录

实现频道未读数持续监听

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

WebElite未读管理示例.png

步骤1: 监听未读数

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

订阅的频道仅在当前登录期间有效(因网络波动导致的断线自动重连除外)。如您调用 destroylogout 方法刷新页面或登出后,需要重新订阅。

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

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

    参数 说明
    channels 频道 ID:传入您需要订阅的频道 ID,以及该频道所属的服务器的 ID。格式为 { channelId: string; serverId: string }[]
    opeType 操作类型:传入 1 订阅指定的频道。
    type 订阅类型:传入 2 订阅频道的未读数。

    入参配置示例代码如下:

    {
      "type": 2,
      "opeType": 1,
      "channels": [
        {
          "serverId": "1426749",
          "channelId": "1344541"
        },
        {
          "serverId": "1426749",
          "channelId": "1344541"
        },
        {
          "serverId": "1426749",
          "channelId": "1344541"
        },
        {
          "serverId": "1426749",
          "channelId": "1344541"
        }
      ]
    }
    

步骤2:清除未读数

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

  1. 进入频道 1 后,记住您应用中“代表该频道的属性” (这里以在圈组 Web Demo 基础上的集成为例,该开发场景下该属性为 currentChannel)。

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

    未读数清零时,SDK 触发 unreadInfo 事件,该事件包含的未读数参数unreadCount0

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

    示例代码如下:

    // mark all message unread
    await qchat.qchatMsg.markMessageRead({
      "serverId": "132305",
      "channelId": "67291",
      "time": 0
    })
    
    // mark all message read
    await qchat.qchatMsg.markMessageRead({
      "serverId": "132305",
      "channelId": "67291",
      "time": new Date().getTime()
    })
    
  3. 根据您的应用逻辑做出判断和处理:当currentChannelunreadInfo事件里的channelId相同时,每当频道 1 有新消息接收时,仍旧会触发unreadInfo事件。

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

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

  1. 确保您已在当前频道中。
  2. 直接调用 getChannelUnreadInfos 查询当前频道未读信息。 示例代码如下:
    const qchat = new QChat({...})
    qchat.qchatChannel.getChannelUnreadInfos({"channels": [
        {
          "serverId": "YOUR_SEVERID",
          "channelId": "YOUR_CHANNELID"
        }
      ]})
    

常见问题

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

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

  • 消息发送者是自己,则未读数不变
  • 如果设置属性historyEnablefalse,即不存云端消息历史,则未读数不变。
  • 如果设置属性needBadgefalse,即不需要消息计数,则未读数不变。
  • 未订阅当前频道。

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

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

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

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

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

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

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

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

此文档是否对你有帮助?
有帮助
去反馈
  • 技术原理
  • 前提条件
  • 实现频道未读数持续监听
  • 步骤1: 监听未读数
  • 步骤2:清除未读数
  • 实现频道未读数的直接获取
  • 常见问题
  • 1. 什么操作会导致频道未读数增加?
  • 2. 什么操作会导致频道未读数减少?
  • 3. 撤回消息和重发消息是否影响未读数?
  • 4. 通过markMessageRead方法标记频道消息已读,对未读数有什么影响?