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