跳到主要内容

超级群概述

超级群(UltraGroup)提供了一种新的群组业务形态。超级群不设置群成员人数上限,允许用户在超级社群中建立社交关系、在海量信息中聚焦自己感兴趣的内容,帮助开发者打造高用户黏性的群体。超级群组成员最多可加入 100 个超级群,每个超级群下的不同频道之间共享一份超级群成员关系。App 内的超级群数量没有限制。

服务端一般用 busChannel 参数表示超级群频道 ID,对应客户端的 channelId 参数。

开通服务

超级群功能需要在控制台超级群服务页面开通。

如何使用频道

超级群支持在群会话中创建独立的频道(busChannel),超级群的会话、消息、未读数等消息数据和群组成员支持分频道进行聚合,各个频道之间消息独立。

频道按类型区分为公有频道与私有频道。公有频道对所有超级群成员开放(无需加入)。该超级群的所有成员都会接收公有频道下的消息。私有频道仅对该频道成员列表上的用户开放。有关私有频道的详细介绍,可参见超级群私有频道概述

超级群业务提供一个 ID 为 RCDefault 的默认频道。RCDefault 频道对所有超级群成员开放,不可转为私有频道。

对于 App 业务来说,如果仅需实现类似群聊的业务,可以利用超级群无成员上限的特性构建大于 3000 人的超大群。这种场景下,可以让所有消息都在 RCDefault 默认频道中进行收发。建议在调用客户端、服务端 API 时指定频道 ID 为 RCDefault

如果仅需实现类似 Discord 类业务,通过超级群频道功能构建子社区,推荐全部使用您自行创建的频道实现您的业务特性。默认频道(RCDefault)与自建频道的行为存在差异,全部使用自建频道可避免这种差异在实现 App 业务逻辑时造成限制。

提示

如果您的 App / 环境在 2022.10.13 日之前开通超级群服务,则您的超级群服务中不存在 RCDefault 频道。在调用客户端、服务端 API 时如果不指定频道 ID,一般仅作用于不属于任何频道的消息,具体行为需参见各功能文档。即时通讯服务支持客户调整服务至最新行为。该行为调整将影响客户端、服务端收发消息、获取会话、清除历史消息、禁言等多个功能。如有需要,请提交工单咨询详细方案。

超级群管理接口

即时通讯服务不会托管用户,也不管理群组的业务逻辑,因此超级群的业务逻辑全部需要在 App 服务器进行实现。

对于客户端开发人员来说,创建群组、频道等基础管理操作只需要与 App 后端交互即可。App 后端需要调用相应的即时通讯服务端 API(Server API)接口相关接口创建超级群、创建频道等其他管理操作。

下表列出了超级群部分基础管理接口。更多接口可参见API 接口列表

功能分类功能描述即时通讯服务端 API
创建、解散超级群提供创建者用户 ID、超级群 ID、和群名称,向即时通讯服务端申请建群。如解散超级群,则群成员关系不复存在。创建超级群解散超级群
加入、退出超级群加入超级群后,默认可查看入群以后产生的新消息。退出超级群后,不再接受该群的新消息。加入超级群退出超级群
修改即时通讯服务端的超级群信息修改在即时通讯的推送服务中使用的超级群信息。更新超级群信息
创建、删除群频道在超级群会话中创建独立沟通的频道。如删除频道,将无法在频道中发送消息。创建频道删除频道
查询群频道列表加入超级群后,默认可查看入群以后产生的新消息。退出超级群后,不再接受该群的新消息。查询频道列表
变更群频道类型超级群频道可以随时切换为公有频道或私有频道。变更频道类型
添加、删除私有频道成员将超级群成员加入或移出指定频道的私有频道成员列表。在频道类型为私有频道时启用该成员列表的数据。添加私有频道成员删除私有频道成员