setGroupCounters

功能介绍

设置群计数器

与 群自定义属性不同 ,群计数器主要用来存储整数类型的数据,您可以使用群计数器来存储一些群相关的附加信息,例如直播群的累计观看人数、观看人次、主播被点赞的次数、观众累计送给主播的礼物数等。

除了话题外,群计数器支持所有的群类型;

群计数器功能仅旗舰版本支持。

如果您即将设置的计数器的 key 存在,则直接更新计数器的 value 值;如果不存在,则直接添加 key-value。

如果多个用户同时设置同一个计数器时,计数器最终的值会相互覆盖,推荐由群主发起设置操作。

setGroupCounters、increaseGroupCounter、decreaseGroupCounter 接口合并计算,SDK 限制为单个登录用户最多 5 秒调用 20 次,超过限制后接口回调 8516 错误码;

需要sdk版本大于或等于1.0.25

参数详解

参数名称 参数类型 是否必填 描述
groupID string 群组ID.
counters NumberMap 计数器对象.

返回模板

V2TimValueCallback<Map<String, number>>

{
    code : number
    desc : string
    data : Map<String, number>
}

返回值详解

名称 数值类型 描述
code number 请求结果错误码
desc string 请求结果描述符
data Map 设置后的计数器结果

代码示例

import { TencentImSDKPlugin } from 'react-native-tim-js';

const SetGroupCountersresponse = await TencentImSDKPlugin.v2TIMManager
    .getGroupManager()
    .setGroupCounters(
        groupID,// 群组id
        counters// 计数器
    );
if (SetGroupCountersresponse.code === 0) {
    // 设置成功
    SetGroupCountersresponse.data; // 设置后的计数器
}

results matching ""

    No results matching ""