# 群组概述

    # 功能描述

    群组是支持多人沟通的即时通讯系统,成员关系相对稳定。所有群成员可以收到群中的消息,可以在群中发送消息。群成员离线时可以收到推送消息。群组成员支持多种角色:群主、群管理员和普通成员。群组提供丰富的管理能力,如群组禁言、群公告和群文件等。

    如需查看消息相关内容,参见 消息管理

    群组支持两种加入授权方式:

    • 需要群主授权加入;
    • 不需要群主授权即可加入。

    # 群组与聊天室的区别

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

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

    # 群组成员角色

    群成员角色
    描述
    管理权限
    普通成员 不具备管理权限的普通成员。 普通成员可以收发消息,查看群组描述信息。
    群管理员 由群主指定,协助群主进行管理,拥有一定的管理权限。 管理员可以更改群组名称和描述信息、对群成员进行管理。
    群主 群组的创建者,在群中拥有最高权限。 群主可以指定管理员、解散群组、将群主权限转移给他人、更改群组名称和描述信息和对群成员进行管理。

    # 群组类型

    群组类型 介绍
    公开群 公开群可以被搜索到,用户只能申请加入群或者被管理员和群主邀请入群。
    私有群 私有群不能被搜索到,用户需要被邀请才能入群。

    # 群组功能

    群组功能主要分为群组的建立和管理,群成员管理,以及群属性管理。

    # 创建和管理群组

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

    # 群成员管理

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

    # 群属性管理

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

    # 群组人数限制

    群成员的数量根据不同的套餐版本而不同,免费版 100 人/群,专业版 300 人/群, 旗舰版 3,000 人/群,尊享版 8,000 人/群。

    更新时间:2023-01-14 22:59:40