sendTextAtMessage method

  1. @Deprecated('sendTextAtMessage自3.6.0开始弃用,我们将创建消息与发送消息分离,请先使用createTextAtMessage创建消息,再调用sendMessage发送消息')
Future<V2TimValueCallback<V2TimMessage>> sendTextAtMessage({
  1. required String text,
  2. required List<String> atUserList,
  3. required String receiver,
  4. required String groupID,
  5. MessagePriorityEnum? priority = MessagePriorityEnum.V2TIM_PRIORITY_NORMAL,
  6. bool onlineUserOnly = false,
  7. bool isExcludedFromUnreadCount = false,
  8. OfflinePushInfo? offlinePushInfo,
})

创建文本消息,并且可以附带 @ 提醒功能

提醒消息仅适用于在群组中发送的消息

参数: atUserList 需要 @ 的用户列表,如果需要 @ALL,请传入 AT_ALL_TAG 常量字符串。 举个例子,假设该条文本消息希望@提醒 denny 和 lucy 两个用户,同时又希望@所有人,atUserList 传 "denny","lucy",AT_ALL_TAG数组 注意:

atUserList 使用注意事项
默认情况下,最多支持 @ 30个用户,超过限制后,消息会发送失败。
atUserList 的总数不能超过默认最大数,包括 @ALL。

Implementation

@Deprecated(
    'sendTextAtMessage自3.6.0开始弃用,我们将创建消息与发送消息分离,请先使用createTextAtMessage创建消息,再调用sendMessage发送消息')
Future<V2TimValueCallback<V2TimMessage>> sendTextAtMessage({
  required String text,
  required List<String> atUserList,
  required String receiver,
  required String groupID,
  MessagePriorityEnum? priority = MessagePriorityEnum.V2TIM_PRIORITY_NORMAL,
  bool onlineUserOnly = false,
  bool isExcludedFromUnreadCount = false,
  OfflinePushInfo? offlinePushInfo,
}) async {
  if (kIsWeb) {
    return await TencentCloudChatSdkPlatform.instance.sendTextAtMessage(
      text: text,
      receiver: receiver,
      groupID: groupID,
      atUserList: atUserList,
      priority: priority!.index,
      onlineUserOnly: onlineUserOnly,
      isExcludedFromUnreadCount: isExcludedFromUnreadCount,
      offlinePushInfo: offlinePushInfo?.toJson(),
    );
  }

  V2TimMsgCreateInfoResult result = TIMMessageManager.instance.createTextAtMessage(
      text: text,
      atUserList: atUserList,
  );

  return await TIMMessageManager.instance.sendMessage(
    id: result.id ?? '',
    receiver: receiver,
    groupID: groupID,
    priority: priority!.index,
    onlineUserOnly: onlineUserOnly,
    isExcludedFromUnreadCount: isExcludedFromUnreadCount,
    offlinePushInfo: offlinePushInfo,
  );
}