文档中心
即时通讯 (环信)
Console 官网 社区 技术支持
简体中文
search-icon

群组概述

更新时间 2023/05/18 06:11:59

群组是支持多人沟通的即时通讯系统，成员关系相对稳定。所有群成员可以收到群中的消息，可以在群中发送消息。当群成员离线时，可以收到推送消息。群组分为公开群和私有群，公开群可以被搜索到，非群成员可以加入；私有群不能被搜索到，需要群主或群管理员添加非群成员进入。群组成员支持多种角色：群主、群管理员、群成员。群组提供丰富的管理能力，如群组禁言、群公告、群文件等。

群组类型

即时通讯 IM 支持两种类型的群组：

  • 公开群：公开群可以搜索到。根据群组的设置，用户可以直接加入公开群，也可以在群主或管理员的批准后加入。
  • 私有群：私有群无法搜索到。用户无法直接申请加入私有群，需要被邀请才能入群。

群组角色和权限

群组具有以下角色和权限：

  • 群主：群组创建者自动成为群主。群主拥有群组的全部管理权限，包括指定群管理员、修改群公告、管理群成员（包括管理员）。群主还可以解散该组或将所有权转让给其他成员。
  • 群组管理员：管理员具备一些管理权限，包括修改组公告和管理群组成员（但不能管理其他管理员）。管理员由群主指定。
  • 群组成员：成员可以发送和接收群消息，没有任何管理权限。

群组与聊天室的区别

群组和聊天室均为支持多人沟通的即时通讯系统。两者的区别在于，群组中的成员会有固定的强关系，成员加入后会长时间在群组中。聊天室中的成员没有固定关系，类似于一个开放的空间，用户可以自由加入，离开即退出聊天室。下表为功能对比：

功能 群组 聊天室
使用场景 类似于微信，QQ 里的群聊，所有加入的用户拥有固定的关系。 类似于斗鱼、虎牙的直播间，成员间没有固定关系，离开即退出。
创建方式 所有 app 用户都可以创建群组。 仅 超级管理员 有权限创建聊天室。
类型 各种类型的群组支持不同的使用场景。 仅有一种类型，所有用户可以自由加入和退出。
最大成员数 支持的最大成员数取决于即时通讯 IM 的版本，最高版本支持 8,000 人。 支持的最大成员数取决于即时通讯 IM 的版本，最高版本支持 10,000 人。如需提升该上限，请联系 sales@agora.io。
消息离线推送 成员离线时会收到推送消息。 成员离线时收不到推送消息；成员离线超过 2 分钟会自动退出聊天室。
离线消息存储 支持离线消息存储，每个会话存储 200 条消息。
用户上线时，会收到离线消息。		 不支持离线消息存储。如果用户加入聊天室时需要服务器推送最新的历史消息，可以联系 sales@agora.io 开通聊天室历史消息推送，每个会话默认支持 10 条消息，最多可调整至 200 条。
消息可靠性 群组中发送的所有消息，群成员都会收到。 当消息量大时，聊天室中超过阈值的消息会被丢弃。消息开始丢弃的阈值为每秒 100 条消息，可以根据需求进行调整。

群组功能

即时通讯 IM SDK 支持创建和管理群组、管理群组成员、修改群组属性。

创建和管理群组

功能 描述
创建群组 群组分为公开群和私有群，可以对加群的方式进行设置。任何用户都可以创建群组。群组创建者为群组。群组数量和群成员数量根据套餐版本有所不同。详见 群组成员总数限制。
解散群组 只有群主才能解散群组。群组一旦解散，所有本地群组数据都会被删除，所有群成员都被强制退出群。
获取群成员列表 所有群组用户都可以从服务器获取群组成员的分页列表。成员按加入群组时的时间戳降序显示。
获取群组列表 用户可以获取公开群列表和自己创建或加入的群组列表。
屏蔽和解除群消息 所有群组成员都可以屏蔽和取消屏蔽群组消息。用户屏蔽群组消息后，他们将不再收到来自指定群组的消息。
监听群组事件 你可以监听群组事件，例如用户何时加入和离开群组，并根据需要添加应用逻辑。

群成员管理

功能 描述
加入群组 用户可以加入群组，公开群可以通过搜索群组 ID 的方式加入，私有群需要群成员邀请才能加入。
退出群组 退出群组分为主动退群和被动退群。被动退群即为被踢出群组。群主不支持退群操作，只能解散群。
变更群主 群主可以将群组的所有权转让给指定的组成员。所有权转移后，群主成为普通群成员。
添加和移除群管理员 群主可以添加成员到群组管理员列表，也可以将管理员移出该列表。管理员列表中的成员获得所有的群管理员权限。
群组白名单 群主和管理员可以将群成员加入或移出白名单。白名单中的群成员可以在全员禁言状态下发送群消息。
群组黑名单 群主和群管理员可以将群成员加入或移出黑名单，黑名单中的成员将被移出群且无法再次加入群。
群组禁言
  • 群主和管理员可以将群成员加入或移出禁言列表，禁言列表中的成员无法发送群消息，但可以接收群消息。
  • 群主和管理员可以开启或关闭全员禁言，开启全员禁言后，仅群组、管理员和白名单中的成员可以发送群消息。

群属性管理

功能 描述
修改群名称和描述 群主和群管理员可以修改群名称和群组描述。
管理群公告 群主和群管理员可以设置和更新群公告，群成员可以获取群公告。
管理共享文件 群主和群管理员可以上传文件并删除所有群共享文件，群成员只能删除自己上传的文件。
更新群扩展字段 群主和群管理员可以修改群组的扩展字段。你可以通过群扩展字段设置 JSON 格式的数据，添加群组扩展信息。群扩展字段的长度限制为 8 KB。

群组人数限制

最大群成员数根据不同的套餐版本而不同，免费版 100 人/群，基础版 10,000 人/群，进阶版 50,000 人/群，企业版默认为 100,000 人/群，可联系 sales@agora.io 提升该上限。