• UIKit
  • SDK
  • 服务端 API
Chat/
SDK/
React Native/
消息/
SDK
  • Run Demo
  • SDK 集成
  • 初始化
  • 登录和注销
  • 消息
    • 消息概述
    • 发送消息
    • 接收消息
    • 历史消息
    • 转发消息
    • 修改消息
    • 消息插入
    • 删除消息
    • 清空消息
    • 撤回消息
    • 在线消息
    • 已读回执
    • 查询消息
    • 群 @ 消息
    • 定向群消息
    • 通知免打扰
    • 消息扩展
  • 群组
    • 产品概述
    • 群组管理
    • 群资料
    • 群成员管理
    • 群成员资料
    • 自定义群属性
    • 社群管理
  • 用户
    • 用户资料
    • 好友管理
    • 好友列表
    • 黑名单
  • 离线推送
    • 离线推送
  • 局部搜索
    • 查找消息
    • 查找好友
    • 查找群组
    • 查找群成员
  • 信令
    • 信令管理
  • Changelog
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

群 @ 消息

功能描述

群 @ 消息就是发送方监听输入栏里的输入字符,当用户输入 @ 字符后,弹出群成员选择界面。选择完需要 @ 的成员后以 “@A @B @C......” 形式显示在输入框,并可以继续编辑消息内容,完成消息发送。 接收方会在会话界面的群聊天列表,重点显示 “有人@我” 或者 “@所有人” 标识,提醒用户有人在群里 @ 自己了。
说明:
目前仅支持文本 @ 消息。

功能演示

监听 @ 字符选择群成员
编辑群 @ 消息发送
收到群 @ 消息



图一:在聊天界面监听到输入框输入 "@" 字符后,可以跳转到群成员选择界面,选择需要 @ 的群成员。 图二:在群成员选择完成后,重新返回聊天界面,继续编辑群 @ 消息发送。 图三:如果有消息 @ 我,自己会收到会话更新,可以在会话 Cell 展示 “有人@我” 信息。

发送群 @ 消息

1. 发送方监听聊天界面的文本输入框,启动群成员选择界面。选择完成后回传选择群成员的 ID 和昵称信息,ID 用来构建消息对象 V2TimMessage,昵称用来在文本框显示。
2. 发送方调用 createTextAtMessage (Details) 接口创建一条 @ 文本消息,拿到消息对象 V2TIMMessage,并在其中指定需要 @ 的成员。
3. 发送方调用 sendMessage (Details) 接口将刚才创建的 @ 消息对象发送出去。
示例代码如下:
const text = "123";
const atUserList = ['user1','user2','all'];

// 创建群@消息
const atMsgRes = await TencentImSDKPlugin.v2TIMManager.getMessageManager().createTextAtMessage(text, atUserList);
// 发送群@消息
TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(
id: atMsgRes.data.id,
receiver: "",
groupID: "",
);

接收群 @ 消息

1. 在加载和更新会话处,需要调用 V2TimConversationgroupAtInfolist (Details) 接口获取会话的 @ 数据列表。
2. 通过列表中 V2TimGroupAtInfo 对象的 atType (Details) 接口获取 @ 数据类型,并更新到当前会话的 @ 信息。
示例代码如下:
const nextSeq = "";
const count = 10;
const getConversationList = await TencentImSDKPlugin.v2TIMManager
.getConversationManager()
.getConversationList(nextSeq, count);
if (getConversationList.code == 0) {
getConversationList.data.conversationList.forEach((element) => {
element.groupAtInfoList.forEach((element) => {
if (element.atType == 0) {
// @我
}
if (element.atType == 1) {
// @all
}
if (element.atType == 2) {
// @all&@我
}
});
});
}