tencent cloud

功能描述

群资料指的是与群组相关的一些信息，相关方法在核心类 TencentImSDKPlugin.v2TIMManager.getGroupManager()中。

获取群资料

您可以调用 getGroupsInfo (Details) 获取群资料。该接口支持一次传入多个 groupID，批量获取多个群的群资料。

代码示例如下：

// 获取群资料
const groupinfos = await groupManager.getGroupsInfo(["groupid1"]);

修改群资料

您可以调用 setGroupInfo (Details) 修改群资料。

如果您事先调用 addGroupListener 添加了群组事件监听器，群资料被修改后，全员会收到 onGroupInfoChanged (Details) 回调。

不同类型的群组，可以修改群资料的成员角色不同：

示例代码如下：

groupManager.setGroupInfo({
groupAddOpt: GroupAddOptTypeEnum.V2TIM_GROUP_ADD_AUTH,
// ...其他资料
});
// 回调
TencentImSDKPlugin.v2TIMManager.addGroupListener({
onGroupInfoChanged: (groupID, changeInfos) => {
  // 群信息更改回调
},
});

设置群消息的接收选项

任何群成员都可以调用 setGroupReceiveMessageOpt (Details) 接口修改群消息接收选项。

V2TIMReceiveMessageOpt 的可选项有：

使用不同的 V2TIMReceiveMessageOpt 可以实现群消息免打扰：

完全不接收群内消息
群消息接收选项设置为 V2TIM_NOT_RECEIVE_MESSAGE 后，群内的任何消息都收不到，会话列表也不会更新。

接收群内消息但不提醒，在会话列表界面显示小圆点（不显示未读数）

1. 群消息接收选项设置为 V2TIM_RECEIVE_NOT_NOTIFY_MESSAGE。
2. 当群内收到新消息，会话列表需要更新时，可以通过会话 V2TIMConversation 中的 unreadCount (Details) 获取到消息未读数。
3. 根据 V2TIMConversation 的 recvOpt (Details) 判断获取到的群消息接收选项为 V2TIM_RECEIVE_NOT_NOTIFY_MESSAGE 时显示小红点而非消息未读数。

说明：

此方式需使用未读计数功能，因此仅适用于好友工作群（Work）和陌生人社交群（Public）。

示例代码如下：

// 社会群接收消息选项
groupManager.setGroupInfo({
groupAddOpt: GroupAddOptTypeEnum.V2TIM_GROUP_ADD_AUTH,
});