浏览 SDKs · Flutter
平台
SDKsFlutter

创建 @ 消息

使用 Flutter SDK 创建群聊 @ 文本消息。

复制

构建群聊中提及(@)指定成员或全体成员的文本消息对象:

参数说明

参数类型是否必填说明
textString是包含 @ 展示文本的消息正文。
atUserIDListList<String>是被提及的目标用户 ID 列表;若提醒全体成员可传入全体标识。
atUserInfoListList<AtUserInfo>?否被提及成员的详细信息列表(包含用户 ID 与群昵称),用于辅助渲染。
quoteMessageMessage?否可选,被同时引用的原始消息对象;不引用则传 null。
final message = await OpenIM.iMManager.messageManager.createTextAtMessage(
  text: '@$userID 请确认',
  atUserIDList: [userID],
  atUserInfoList: [AtUserInfo(atUserID: userID, groupNickname: nickname)],
  quoteMessage: quotedMessage,
);

返回结果

Future 成功返回待发送的 @ 消息对象(Message),其内容存储在 atTextElem 中。

创建操作仅在本地组装消息数据,不会自动执行网络发送,也不会触发新消息事件通知。构建完成后,需将返回的 Message 对象传给发送消息,并在发送方法中指定对应的群组 ID。