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; // 设置后的计数器
}