deleteMessages method

Future<V2TimCallback> deleteMessages({
  1. List<V2TimMessage>? messageList,
  2. List<String>? msgIDs,
  3. List? webMessageInstanceList,
})

删除本地及漫游消息

messageList 删除的消息列表

msgIDs 待废弃 请使用 messageList

webMessageInstanceList 这个参数 web 独有其中元素是 web 端的 message 实例,具体请看web文档

该接口会删除本地历史的同时也会把漫游消息即保存在服务器上的消息也删除,卸载重装后无法再拉取到。需要注意的是:

  • 一次最多只能删除 30 条消息
  • 要删除的消息必须属于同一会话
  • 一秒钟最多只能调用一次该接口
  • 如果该账号在其他设备上拉取过这些消息,那么调用该接口删除后,这些消息仍然会保存在那些设备上,即删除消息不支持多端同步。

Implementation

Future<V2TimCallback> deleteMessages({
  List<V2TimMessage>? messageList,
  List<String>? msgIDs,
  List<dynamic>? webMessageInstanceList}) async {
  if (kIsWeb) {
    return TencentCloudChatSdkPlatform.instance.deleteMessages(
        msgIDs: msgIDs, webMessageInstanceList: webMessageInstanceList);
  }

  if (messageList != null) {
    return TIMMessageManager.instance.deleteMessagesWithMessage(messageList: messageList);
  } else {
    return TIMMessageManager.instance.deleteMessages(msgIDs: msgIDs);
  }
}