Class V2TIMGroupManager

1.1 创建自定义群组（高级版本：可以指定初始的群成员）

Note

• 后台限制邀请的群成员个数不能超过 20
• 其他限制请参考

Ref

V2TIMManager.h -> CreateGroup 注释

1.2 获取当前用户已经加入的群列表

Note

• 直播群(AVChatRoom) 不支持该 API。
• 该接口有频限检测，SDK 限制调用频率为1 秒 10 次，超过限制后会报 ERR_SDK_COMM_API_CALL_FREQUENCY_LIMIT （7008）错误

2.1 拉取群资料

2.2 搜索群资料（5.4.666 及以上版本支持）

Note

该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明

2.3 修改群资料

2.4 初始化群属性，会清空原有的群属性列表

Note

attributes 的使用限制如下：

• 6.7 及其以前版本，只支持 AVChatRoom 直播群；
• 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
• 从 7.0 版本开始，除了话题外，群属性支持所有的群类型；
• key 最多支持 16 个，长度限制为 32 字节；
• value 长度限制为 4k；
• 总的 attributes（包括 key 和 value）限制为 16k；
• initGroupAttributes、setGroupAttributes、deleteGroupAttributes 接口合并计算， SDK 限制为 5 秒 10 次，超过后回调 8511 错误码；后台限制 1 秒 5 次，超过后返回 10049 错误码；
• getGroupAttributes 接口 SDK 限制 5 秒 20 次；
• 从 5.6 版本开始，当每次APP启动后初次修改群属性时，请您先调用 getGroupAttributes 拉取到最新的群属性之后，再发起修改操作；
• 从 5.6 版本开始，当多个用户同时修改同一个群属性时，只有第一个用户可以执行成功，其它用户会收到 10056 错误码；收到这个错误码之后，请您调用 getGroupAttributes 把本地保存的群属性更新到最新之后，再发起修改操作。

2.5 设置群属性。已有该群属性则更新其 value 值，没有该群属性则添加该属性。

Note

• 6.7 及其以前版本，只支持 AVChatRoom 直播群；
• 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
• 从 7.0 版本开始，除了话题外，群属性支持所有的群类型。

2.6 删除指定群属性，keys 传大小为 0 的 string[] 则清空所有群属性。

Note

• 6.7 及其以前版本，只支持 AVChatRoom 直播群；
• 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
• 从 7.0 版本开始，除了话题外，群属性支持所有的群类型。

2.7 获取指定群属性，keys 传 keys 传大小为 0 的 string[] 则获取所有群属性。

Note

• 6.7 及其以前版本，只支持 AVChatRoom 直播群；
• 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
• 从 7.0 版本开始，除了话题外，群属性支持所有的群类型。

2.8 获取指定群在线人数

Note

请注意：

• IMSDK 7.3 以前的版本仅支持直播群（ AVChatRoom）；
• IMSDK 7.3 及其以后的版本支持所有群类型。

2.9 设置群计数器（7.0 及其以上版本支持）

Note

• 该计数器的 key 如果存在，则直接更新计数器的 value 值；如果不存在，则添加该计数器的 key-value；
• 当群计数器设置成功后，在 succ 回调中会返回最终成功设置的群计数器信息；
• 除了社群和话题，群计数器支持所有的群组类型。

2.10 获取群计数器（7.0 及其以上版本支持）

Note

• 如果 keys 为空，则表示获取群内的所有计数器；
• 除了社群和话题，群计数器支持所有的群组类型。

2.11 递增群计数器（7.0 及其以上版本支持）

Note

• 该计数器的 key 如果存在，则直接在当前值的基础上根据传入的 value 作递增操作；反之，添加 key，并在默认值为 0 的基础上根据传入的 value 作递增操作；
• 除了社群和话题，群计数器支持所有的群组类型。

2.12 递减群计数器（7.0 及其以上版本支持）

Note

• 该计数器的 key 如果存在，则直接在当前值的基础上根据传入的 value 作递减操作；反之，添加 key，并在默认值为 0 的基础上根据传入的 value 作递减操作
• 除了社群和话题，群计数器支持所有的群组类型。

3.1 获取群成员列表

Note

• 普通群（工作群、会议群、公开群）的限制：

1. filter 只能设置为 V2TIMGroupMemberFilter 定义的数值，SDK 会返回指定角色的成员。

• 直播群（AVChatRoom）的限制：

1. 如果设置 filter 为 V2TIMGroupMemberFilter 定义的数值，SDK 返回全部成员。 返回的人数规则为：拉取最近入群群成员最多 1000 人，新进来的成员排在前面。 需要升级旗舰版，并且在 控制台 开启“直播群在线成员列表”开关。 （6.3 及以上版本支持）。
2. 如果设置 filter 为群成员自定义标记，旗舰版支持拉取指定标记的成员列表。 标记群成员的设置请参考 MarkGroupMemberList API。
3. 程序重启后，请重新加入群组，否则拉取群成员会报 10007 错误码。
4. 群成员资料信息仅支持 userID | nickName | faceURL | role 字段。

• 社群（Community）的限制：

1. 如果设置 filter 为 V2TIMGroupMemberFilter 定义的数值，SDK 返回指定角色的成员。
2. 如果设置 filter 为群成员自定义标记，旗舰版支持拉取指定标记的成员列表(7.5 及以上版本支持）。标记群成员的设置请参考 markGroupMemberList API。

3.2 获取指定的群成员资料

3.3 搜索群成员（5.4.666 及以上版本支持）

Note

该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明

3.4 修改指定的群成员资料

3.5 禁言（只有管理员或群主能够调用）

3.6 禁言全体群成员，只有管理员或群主能够调用（7.5 及以上版本支持）

Note

• 禁言全体群成员没有时间限制，设置 isMute 为 false 则解除禁言。
• 禁言或解除禁言后，会触发 V2TIMGroupListener 中的 onAllGroupMembersMuted 回调。
• 群主和管理员可以禁言普通成员。普通成员不能操作禁言/解除禁言。

3.7 邀请他人入群

Note

请注意不同类型的群有如下限制：

• 工作群（Work）：群里的任何人都可以邀请其他人进群。
• 会议群（Meeting）和公开群（Public）：只有通过rest api 使用 App 管理员身份才可以邀请其他人进群。
• 直播群（AVChatRoom）：不支持此功能。
• 单次邀请的群成员个数不能超过 20（7.1 及其以上版本开始限制）。

3.8 踢人（直播群踢人从 6.6 版本开始支持，需要您购买旗舰版套餐）

Note

请注意不同类型的群有如下限制：

• 从 7.2 版本开始，支持设置一个时长参数，用于指定用户从被踢出群组开始算起，禁止重新申请加群的时长;
• 工作群（Work）：只有群主或 APP 管理员可以踢人。
• 公开群（Public）、会议群（Meeting）：群主、管理员和 APP 管理员可以踢人
• 直播群（AVChatRoom）：6.6 之前版本只支持禁言（MuteGroupMember），不支持踢人（KickGroupMember）。6.6 及以上版本支持禁言和踢人。
• 该接口其他使用限制请查阅：https://cloud.tencent.com/document/product/269/75400#.E8.B8.A2.E4.BA.BA。

3.9 切换群成员的角色。

Note

请注意不同类型的群有如下限制：

• 公开群（Public）和会议群（Meeting）：只有群主才能对群成员进行普通成员和管理员之间的角色切换。
• 其他群不支持设置群成员角色。
• 转让群组请调用

Ref

TransferGroupOwner 接口。

• 会议群（Meeting）切换群成员角色之后，不会有 OnGrantAdministrator 和 OnRevokeAdministrator 通知回调
• 切换的角色支持普通群成员（V2TIM_GROUP_MEMBER_ROLE_MEMBER）和管理员（V2TIM_GROUP_MEMBER_ROLE_ADMIN）

3.10 标记群成员(从 6.6 版本开始支持，需要您购买旗舰版套餐)

Note

请注意

• 直播群从 6.6 版本开始支持。
• 社群从 7.5 版本开始支持。
• 只有群主才有权限标记群组中其他人。

3.11 转让群主

Note

请注意不同类型的群有如下限制：

• 普通类型的群（Work、Public、Meeting）：只有群主才有权限进行群转让操作。
• 直播群（AVChatRoom）：不支持转让群主。

4.1 获取加群申请列表

Note

最多支持50个

4.2 同意某一条加群申请

4.3 拒绝某一条加群申请

4.4 标记申请列表为已读