浏览 SDKs · Android
平台
SDKsAndroid

创建 @ 消息

在群聊中创建包含指定成员 @ 提醒与可选引用的文本消息。

复制

构建带有 @ 群成员提醒的文本消息对象,并支持同时引用某条已有消息。当消息送达被 @ 的成员时,接收端会触发会话的 @ 强提醒状态。

String text = "@张三 请查看最新产品方案";
List<String> userIDs = Collections.singletonList("user_zhangsan");

AtUserInfo atUserInfo = new AtUserInfo();
atUserInfo.setAtUserID("user_zhangsan");
atUserInfo.setGroupNickname("张三");
List<AtUserInfo> atUserInfos = Collections.singletonList(atUserInfo);

Message quoteMessage = null; // 如需同时引用历史消息则传入对应 Message 对象

Message message = OpenIMClient.getInstance().messageManager.createTextAtMessage(
    text,
    userIDs,
    atUserInfos,
    quoteMessage
);

参数说明

参数类型是否必填说明
textString是包含 @ 展示文本的完整消息正文。
userIDsList<String>是被提醒群成员的用户 ID 列表(去重后传入)。
atUserInfosList<AtUserInfo>是被提醒成员的用户信息列表,应与 userIDs 对应。
quoteMessageMessage否同时作为对某条消息的引用回复时传入被引用的消息;无引用时传 null。

返回结果

返回创建完成的待发送 Message 对象。

@ 提醒主要用于群聊场景。创建完成后,调用发送消息将该消息发送至对应群组。