createAtSignedGroupMessage method

Future<V2TimValueCallback<V2TimMessage>> createAtSignedGroupMessage({
  1. V2TimMessage? message,
  2. String? createdMsgID,
  3. required List<String> atUserList,
})

创建带 @ 标记的群消息

message 原始消息对象

createdMsgID 创建消息的 id,待废弃。请直接传入通过 createXXXMessage 返回的消息对象给 message 参数。

atUserList 需要 @ 的用户列表,如果需要 @ALL,请传入 V2TimGroupAtInfo.AT_ALL_TAG 常量字符串。

注意:

  • 默认情况下,最多支持 @ 30个用户,超过限制后,消息会发送失败。
  • atUserList 的总数不能超过默认最大数,包括 @ALL。
  • 直播群(AVChatRoom)不支持发送 @ 消息。

Implementation

Future<V2TimValueCallback<V2TimMessage>> createAtSignedGroupMessage({
  V2TimMessage? message,
  String? createdMsgID,
  required List<String> atUserList,
}) async {
  if (kIsWeb) {
    return TencentCloudChatSdkPlatform.instance.createAtSignedGroupMessage(
      createdMsgID: createdMsgID,
      atUserList: atUserList,
    );
  }

  V2TimMsgCreateInfoResult? result = TIMMessageManager.instance.createAtSignedGroupMessage(
    message: message,
    createdMsgID: createdMsgID ?? "",
    atUserList: atUserList,
  );

  if (result.messageInfo != null) {
    return V2TimValueCallback<V2TimMessage>.fromObject(result.messageInfo!);
  } else {
    return V2TimValueCallback<V2TimMessage>.fromBool(false, "param is invalid");
  }
}