deleteMessages
功能介绍
删除本地及漫游消息
该接口会在删除本地消息的基础上,同步删除云端存储的消息,且无法恢复。
每次调用,最多只能删除 30 条消息。
每次调用,待删除的消息必须属于同一会话。
1 秒钟最多只能调用 1 次该接口。
如果一个账号在某设备上拉取过这些消息,那么调用该接口删除云端消息后,这些消息仍然会保存在该设备上,即删除消息不支持多端同步。
如果删除的是最后一条消息,会话的 lastMessage 会变为前一条消息。
参数详解
参数名称 | 参数类型 | 是否必填 | 平台 | 描述 |
---|---|---|---|---|
msgIDs | List< String > | 是 | 全部 | 需要删除的消息id列表 |
webMessageInstanceList | List< dynamic > | 否 | 全部 | 需要删除的web端消息实例列表 |
返回模板
V2TimCallback
{
code : int
desc : String
}
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
code | int | 请求结果错误码 |
desc | String | 请求结果描述 |
代码示例
// 删除本地及漫游消息
V2TimCallback deleteMessagesRes = await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.deleteMessages(msgIDs: ['messageid'], // 需要删除的消息id
webMessageInstanceList: [] // 需要删除的web端消息实例列表
);
if (deleteMessagesRes.code == 0) {
//删除成功
}