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

查询@我的消息

更新时间: 2023/02/09 20:54:04

SDK 支持查询指定频道中@当前用户的未读消息,同时也支持批量查询消息是否@当前用户。

其中@当前用户的未读消息包括以下三种:

  • 未读消息设置的@账号列表中包含当前用户。
  • 未读消息设置的需要@的身份组(不包括 everyone 身份组)中包含当前用户。
  • 未读消息设置的需要@所有人。

查询结果中不包括自己发送的消息。

查询指定频道中@当前用户的未读消息

通过调用 GetMentionedMeMessages 方法查询指定频道中@当前用户的未读消息列表。

其中入参 timestamp 为查询起始时间,传入 0 表示当前时间,查询 ackTime(用户查看过的最后一条信息的时间)到 timestamp时间范围内@当前用户的未读消息。查询顺序默认为倒序查询。

limit 指查询的消息数量上限,默认值和最大值都为 200。当 limit 传入 0,则使用默认值 200。

如果查询时间范围之间消息大于 limit 条,返回 limit 条记录;如果小于 limit 条,返回实际条数;当已经查询到头时,返回的结果列表的 size 可能会比 limit 小。

示例代码:

QChatGetMentionedMeMessagesParam param;
param.server_id = 123456;
param.channel_id = 123456;
param.timestamp = 0;
param.limit = 0;
param.cb = [this](const QChatGetMentionedMeMessagesResp& resp) {
    // process resp
    // ......
};
Message::GetMentionedMeMessages(param);

批量查询消息是否@当前用户

通过调用 AreMentionedMeMessages 方法批量查询消息是否@当前用户。

传入的待查询的消息必须为同一服务器下的消息,否则将返回 10414错误码。

传入的 messages 最多 100 条,即调用该接口一次最多查询 100 条消息。

示例代码:

QChatAreMentionedMeMessagesParam param;
QChatMessage msg{};
// fill msg
param.messages.push_back(msg);
param.cb = [this](const QChatAreMentionedMeMessagesResp& resp) {
    // process resp
    // ......
};
Message::AreMentionedMeMessages(param);
此文档是否对你有帮助?
有帮助
我要吐槽
  • 查询指定频道中@当前用户的未读消息
  • 批量查询消息是否@当前用户