IM 即时通讯
Windows/macOS
产品介绍
简介
主要功能
产品优势
海外数据中心
IM平滑迁移方案
接口及业务限制
功能介绍
帐号集成与登录
基础消息功能
群组功能
聊天室功能
聊天室标签功能
圈组功能
多端登录与互踢策略
质量数据监控台
更新日志
Demo 更新日志
NIM SDK 更新日志
快速开始
实现单聊消息收发(不含 UI)
实现圈组消息收发(不含 UI)
开发指南
概要介绍
集成方式(当前版本)
集成方式(Windows旧版本)
集成方式(macOS旧版本)
初始化
登录登出
消息收发
最近会话
历史记录
用户资料托管
好友关系托管
事件订阅
系统通知
系统通知概述
内置系统通知管理
内置系统通知未读数
自定义系统通知收发
群组功能
群组概述
群组管理
群成员管理
群消息管理
超大群功能
开通聊天室功能
聊天室
圈组功能
初始化
登录圈组
圈组服务器管理
圈组服务器成员管理
游客功能
频道相关
频道管理
频道分组
频道分组黑白名单
频道未读数管理
搜索服务器和频道
身份组相关
身份组概述
身份组应用场景
服务器身份组
频道身份组
频道分组身份组
频道用户定制权限
自定义权限项
成员权限判定
身份组相关查询
圈组订阅机制
圈组消息相关
圈组消息收发
圈组消息撤回
圈组消息更新
圈组消息删除
会话消息回复(Thread)
圈组快捷评论
获取频道最后一条消息
消息正在输入
圈组消息搜索
圈组消息查询
查询@我的消息
服务器未读数
圈组系统通知
圈组系统通知概述
圈组系统通知收发
圈组系统通知更新
圈组各端接口命名差异
语音录制与播放
NOS云存储服务
文档转换
API 参考
Windows/macOS API 参考
状态码
IM 控制台指南
创建应用
注册 IM 账号
升级服务
配置应用客户端标识
参考文档
升级指引
开发示例
UI库指南
Demo源码导读
打包发布
类与常量定义说明
常见问题
FAQ
服务协议

获取频道最后一条消息

更新时间: 2022/11/17 14:02:36

网易云信 IM 的圈组模块支持在频道列表显示当前各频道的最后一条消息,且开发者可通过在应用上层自行开发相关业务逻辑,实现频道列表动态更新各频道的最后一条消息。

频道列表显示最后一条消息的简易 UI 示例如下:

频道最后一条消息UI示例.png

接口介绍

网易云信 NIM SDK 的Message类提供GetLastMessages方法,用于获取多个频道的最后一条消息的初始数据。

该方法的响应QChatGetLastMessagesResp返回的结果为 map, key 值对应每一个channel_id,value 值是消息体QChatMessage

实现方法

前提条件

已登录圈组,并已创建圈组服务器和频道。

实现流程

  1. 获取频道最后一条消息的初始数据。

    1. 调用GetChannelsByPage拉取频道列表。
    2. 调用GetLastMessages方法获取若干个频道的最后一条消息。
    • 您需自行维护调用该方法返回的结果。
    • 被撤回的消息仍能通过调用该方法查到,但被删除的消息无法查到。如果最后一条消息是撤回消息,推荐把对应的最后一条消息置空,并给出提示表明“撤回消息”。
    1. 在您的应用内存中维护相关频道的最后一条消息。
  2. 注册消息接收回调(RegRecvCb)和消息更新回调(RegUpdatedCb),分别监听各频道的消息接收和消息更新。

  3. 参照下表,在您的应用层自行开发,实现后续频道最后一条消息在不同场景下的动态更新。

    场景
    场景说明 推荐处理方法
    回调触发更新最后一条消息 频道内,其他用户发送消息或重发消息,触发消息接收回调 更新频道最后一条消息
    频道内,其他用户撤回、更新或删除消息,触发消息更新回调 判断撤回、更新、删除的消息是否为频道最后一条消息,若非最后一条消息,则忽略;若为最后一条消息,且:
    • 为撤回或删除消息,则把最后一条消息置空
    • 为更新消息,则更新频道最后一条消息
    用户自己调用 API 后触发更新最后一条消息 自己在频道内发送、重发或更新消息 更新频道内最后一条消息
    自己在频道内撤回或删除消息 判断撤回或删除的消息是否为频道最后一条消息,若非最后一条消息,则忽略;若为最后一条消息,则把最后一条消息置空

API调用时序示例

下图以用户A、用户B 和用户C 的消息交互为例,为您展示实现频道最后一条消息动态更新的 API 调用时序,供您参考。

频道最后一条消息(PC).png

示例代码

获取初始数据

QChatGetLastMessagesParam param;
param.server_id = 123456;
param.channel_ids = {123456, 456789};
param.cb = [this](const QChatGetLastMessagesResp& resp) {
    if (resp.res_code != NIMResCode::kNIMResSuccess) {
        // error handling
        return;
    }
    // process response
    // ...
};
Message::GetLastMessages(param);

回调触发更新最后一条消息

QChatRegMsgUpdatedCbParam reg_msg_updated_cb_param;
reg_msg_updated_cb_param.cb = [this](const QChatMsgUpdatedResp& resp) {
    if (resp.res_code != NIMResCode::kNIMResSuccess) {
        // error handling
        return;
    }
    // process response
    // ...
};
Message::RegUpdatedCb(reg_msg_updated_cb_param);

用户自己调用API后触发更新最后一条消息

具体示例代码请参见圈组消息管理

API参考

API
说明
GetLastMessages 获取多个频道的最后一条消息
此文档是否对你有帮助?
有帮助
我要吐槽
  • 接口介绍
  • 实现方法
  • 前提条件
  • 实现流程
  • API调用时序示例
  • 示例代码
  • 获取初始数据
  • 回调触发更新最后一条消息
  • 用户自己调用API后触发更新最后一条消息
  • API参考