MsgListDelete
功能介绍
消息删除
本接口会在删除本地消息的同时也会删除漫游消息。需要注意以下几点:
建议将之前的消息数组Json保存,然后删除的时候直接调用接口,避免构造消息数组。
一次最多只能删除 30 条消息。
一秒钟最多只能调用一次该接口。
如果该账号在其他设备上拉取过这些消息,那么调用该接口删除后,这些消息仍然会保存在那些设备上,即删除消息不支持多端同步。
参数详解
重载1
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
conv_id | string | 是 | 会话ID |
conv_type | TIMConvType | 是 | 会话类型 |
message_list | List< Message > | 是 | 被删除消息列表 |
callback | NullValueCallback | 是 | 异步回调 |
重载2
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
conv_id | string | 是 | 会话ID |
conv_type | TIMConvType | 是 | 会话类型 |
message_list | List< Message > | 是 | 被删除消息列表 |
callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数:
code:int
desc:string
json_param:'' // json_params为空字符串""
user_data:string
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
TIMResult | TIMResult | 调用接口的返回值 |
code | int | 值为ERR_SUCC表示成功,其他值表示失败。详情请参考 错误码 |
desc | string | 错误描述字符串 |
json_param | string | Json字符串,不同的接口,Json字符串不一样 |
user_data | string | ImSDK负责透传的用户自定义数据,未做任何处理 |