即时通信 IM 群组系统

一、群组系统简介

群组系统是一个支持多人聊天的即时通信系统，以下视频为你详细介绍群组系统：

群组系统所具备的基本能力包括：

·完备的 群组管理 能力：创建/解散群组、成员管理、群组资料管理、成员资料管理等。

·稳定可靠的消息收发能力，完善的 群组消息 管理机制：权限控制，禁言，消息回调，消息漫游等。

·根据常见使用场景，默认配置了好友工作群（Work）、陌生人社交群（Public）、临时会议群（Meeting）、直播群（AVChatRoom）和社群（Community）五个群组类型。

·群组可拓展的成员人数上限：

·好友工作群（Work）、陌生人社交群（Public）和临时会议群（Meeting）成员人数上限最高支持付费拓展到6000人，详情请参阅 价格说明。

·社群（Community）常规为10万人，最高支持100万人（企业版 客户可 提交工单 进行申请）

·直播群（AVChatRoom）成员人数无上限。

除此之外，即时通信 IM 群组系统具备高度可定制性，具体包括：

·自定义消息元素

·自定义群组 ID

·自定义话题 ID

·自定义字段

·自定义回调

二、成员角色介绍

群组中各成员的角色及其权限如下表：

三、群组类型介绍

根据常见使用场景，默认配置了以下群组类型：

四、群组基础能力操作差异

注意：说明：

五、加群方式差异

注意：说明：

六、成员管理能力差异

七、群组限制差异

八、消息能力差异

九、批量导入与自动回收差异

注意：如果需要开启群组回收功能，可以根据 工单模板 提交工单进行申请。配置后，将会根据群组类型清理不活跃群组（群组不活跃是指群组中既没人发言，也没有成员变更）。

十一、群基础资料

注意：群组名称、群组简介、群组公告和群组头像 URL 字段的修改权限如下：

十二、成员资料

十三、权限组资料

十四、权限组中权限介绍

对群组中的权限管理主要通过权限组资料中的权限和针对话题的权限来完成。其中每一位代表一个权限，当设置某个权限位为1时，代表具有此项管理权限。

十五、权限组中的权限含义介绍

十六、针对话题的权限介绍

十七、自定义群组 ID

默认情况下，App 创建群时，即时通信 IM 会为新创建的群组分配一个默认的群组 ID。该 ID 将以 @TGS# 开头，且保证在 App 中唯一。
为了使得群组 ID 更加简单，便于记忆传播，即时通信 IM 支持 App 在通过 REST API 创建群组时自定义群组 ID。自定义群组 ID 必须为可打印 ASCII 字符（0x20-0x7e），最长48个字节，且前缀不能为 @TGS#（避免与默认分配的群组 ID 混淆）。

注意：社群（Community）前缀必须是@TGS#_。

十八、自定义话题 ID

默认情况下，App 创建话题时，即时通信 IM 会为新创建的话题分配一个默认的话题 ID。该 ID 将以 GroupId+@TOPIC#_开头，且保证在群组内唯一。

为了使得话题 ID 更加简单，便于记忆传播，即时通信 IM 支持 App 在通过 REST API 创建话题时自定义话题 ID。自定义话题 ID 的形式为 GroupId+@TOPIC#_+ 自定义部分，其中自定义部分不能包括 @TGS#_和@TOPIC#_@TOPIC#（避免与默认分配的群组 ID 混淆）, 且必须为可打印 ASCII 字符（0x20-0x7e）。

例如 GroupId 为 @TGS#_@TGS#cQVLVHIM62CJ，自定义部分为 TestTopic，则最终的自定义话题 ID 为 @TGS#_@TGS#cQVLVHIM62CJ@TOPIC#_TestTopic。整个自定义话题 ID 长度需要保证在96个字节内。


十九、自定义权限组 ID

默认情况下，App 创建权限组时，即时通信 IM 会为新创建的权限组分配一个默认的权限组 ID。该 ID 将以 @PMG#_@PMG#开头，且保证在群组内唯一。

为了使得权限组 ID 更加简单，便于记忆传播，即时通信 IM 支持 App 在通过 REST API 创建权限组时自定义权限组 ID。自定义权限组 ID 必须以@PMG#_开头（但是不能以@PMG#_@PMG#开头，避免与默认分配的权限组 ID 混淆）且为可打印 ASCII 字符（0x20-0x7e）。

20、自定义字段

即时通信 IM 支持 App 根据业务需求，在群组和群成员两个维度上设置自定义字段。群组维度最多支持10个字段，群成员维度最多支持5个字段。利用自定义字段，App 可以将一些额外数据附加到群组之上，并可以通过现有接口进行读写操作。

21、特性介绍

每个自定义字段有以下特性：

·为 Key-Value 形式。

·Key 为 String 类型，长度不超过16字节，其命名仅支持英文大小写字母、数字、下划线。

·Value 为用户自定义 Buffer，可以为二进制数据，群维度的 Value 长度不超过512字节，群成员维度的 Value 长度不超过64字节。如果 Value 是二进制数据，需要转化为可打印纯文本字符流再使用，避免 json 格式不支持二进制数据嵌入等因素，例如可将二进制数据转换为 base64格式。

·支持配置每个 Key 的最小读权限、最小写权限。

每个自定义字段的读写权限从高到低分别为：

1. App 管理员可读/可写。

2. 群主可读/可写。

3. 群管理员可读/可写。

4. 普通成员可读/可写。

5. 任何人（包括非成员）可读/可写。

例如，App 需要在群组中扩展一个字段 GroupLevel，其 Value 为一个数字，用于记录该群的等级信息。假设等级信息需要 App 后台计算得出，那么该字段的最小写权限应当为“App 管理员可写”。该字段应当为群的公开资料，故而其最小读权限应当为“任何人（包括非成员）可读”。

对于 C/C++ 开发者，如果需要存储的 Value 是数字，建议将其存储为数字的字符串形式，而非其二进制形式（例如，当存储的数字是1时，建议存储字符串“1”，而非二进制数据 0x01）。对于自定义字段，即时通信 IM 后续会扩展出更多操作方式，例如对 Value 进行特定数学操作等，这些运算未来都会以基于字符串形式表示的数字来进行操作。

注意：说明：

注意：直播群（AVChatRoom）中，自定义字段的操作权限说明如下：

22、配置方法

这两个维度的自定义字段，都可以通过即时通信 IM 控制台进行配置。
配置群成员维度的自定义字段前，需要先指定群组类型。但对于直播群（AVChatRoom）及以其为参考的群组类型，因为不存储所有群成员的资料，所以不支持群成员维度的自定义字段。
“自己的读写权限”是指对于用户本人的群成员维度自定义字段值，自己是否有读写权限。例如，群成员维度的自定义字段 “MemberLevel”，用于表示成员在群组中的等级，本人可以读取自己的等级，但无权修改自己的等级，因此字段的“自己的读写权限”为“可读/不可写”。

注意：不支持删除或者修改已配置的自定义字段，请谨慎操作。

23、自定义回调

第三方回调是 App 实现特殊需求的重要方式之一，为用户提供了自定义行为的能力。
即时通信 IM 群组系统支持多种回调，具体参见 第三方回调简介以及 回调命令列表。