TIMMsgSetC2CReceiveMessageOpt
功能介绍
设置针对某个用户的 C2C 消息接收选项（支持批量设置）
您可以通过参数 userIDList 设置一批用户，但一次最大允许设置 30 个用户
该接口调用频率被限制为 1 秒内最多调用 5 次。
完全不接收消息: 消息接收选项设置为 kTIMRecvMsgOpt_Not_Receive 后，单聊/群聊的任何消息都收不到，会话列表也不会更新。
接收消息但不提醒: 在会话列表界面显示小圆点（不显示未读数), 消息接收选项设置为 kTIMRecvMsgOpt_Not_Notify
当单聊/群聊收到新消息，会话列表需要更新时，可以通过会话 V2TIMConversation 中的 unreadCount 获取到消息未读数。
根据 V2TIMConversation 的 recvOpt 判断获取到的消息接收选项为 kTIMRecvMsgOpt_Not_Notify 时显示小红点而非消息未读数。
参数详解
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| msgSetC2CReceiveMessageOptParams | MsgSetC2CReceiveMessageOptParams | 是 | 设置针对某个用户的 C2C 消息接收选项的参数 |
返回模板
Promise<commonResult<string>>
{
code: TIMResult | TIMErrCode;
desc?: string | undefined;
json_param?: string | undefined;
json_params?: string | undefined; // 兼容
user_data?: string | undefined;
}
返回值详解
| 名称 | 数值类型 | 描述 |
|---|---|---|
| code | TIMResult ｜ TIMErrCode | 返回状态码 |
| desc | string ｜ undefined | 返回描述 |
| json_param | string ｜ undefined | 根据具具体接口返回 |
| json_params | string ｜ undefined | 兼容的字段，某些情况下会返回这个，根据具体接口返回 |
| user_data | string ｜ undefined | ImSDK负责透传的用户自定义数据，未做任何处理 |
代码示例
import TimRender from "im_electron_sdk/dist/renderer";
const timRenderInstance = new TimRender();
import { MsgSetC2CReceiveMessageOptParams } from "im_electron_sdk/dist/interfaces";
let userId = ''
let opt = 0
let param:MsgSetC2CReceiveMessageOptParams = {
params: [userId],
opt: opt,
user_data: "123"
}
const {code} = await timRenderInstance.TIMMsgSetC2CReceiveMessageOpt(param);
if(code == 0){
// 成功
}