群组管理

消息群组是指在社交平台或直播互动服务中,为了方便多人之间的信息交流与互动而创建的虚拟集合体。在直播场景下,消息群组能增强观众之间的互动性以及观众与主播之间的互动。

使用说明

  1. 使用群组管理前,您必须已经创建互动消息应用。详细信息,请参见创建应用

  2. 单个互动消息应用下最多可创建5000个互动消息群组(已删除的群组不占额度)。

  3. 群组被删除后还会在列表中存在大约30天左右,之后会从列表中清理掉。

创建群组

  1. 登录视频直播控制台

  2. 在左侧导航栏选择直播+ > 互动消息 > 群组管理,进入群组管理页面。

  3. 选择数据中心和互动消息应用后,单击创建群组

  4. 创建互动消息群组对话框中,根据实际需求配置参数。

    参数

    说明

    群组ID

    创建的群组ID,保证群组ID唯一,由大小写字母、数字组成,长度不超过64字节。

    群组名称

    群组名,长度不超过128字节。

    群主设置

    群组创建者ID,由大小写字母、数字组成,长度不超过64字节。

    管理员设置

    管理员用户ID,由大小写字母、数字组成,长度不超过64字节。多个用半角逗号(,)隔开,最多不超过3个。

    群扩展信息

    群组扩展信息,最大32K字符。

  5. 单击确定,创建互动消息群组。

后续步骤

修改群组配置

  1. 群组管理页面,选择需要修改的群组,在操作列单击查看详情

  2. 在弹出的群组信息面板中,修改相关参数信息即可。

发送消息

  1. 群组管理页面,选择群组,在操作列单击发送消息

  2. 在弹出的发送消息对话框中,根据实际需求配置参数,单击确定

    说明

    目标群组需要时激活状态,即当前群组中有用户已加入,才能正常往群组发送消息。如果遇到发送消息失败,请先确认当前群组中是否有用户。

    参数

    说明

    发送者ID

    发送者ID,由大小写字母、数字组成,长度不超过64字节。

    发送者扩展信息

    发送消息用户的扩展信息,长度不超过512字节。

    消息类型

    消息类型需要传入数字。

    信息内容

    消息体,长度不超过15KB。

删除群组

  1. 群组管理页面,选择需要删除的群组,在操作列单击删除群组

  2. 在弹出的对话框中,单击确定。删除操作不可逆,请谨慎操作。

    说明
    1. 群组删除后,不再可用,正在群组中的所有人,会被通知群已结束。

    2. 群组删除后,消息在7天内可查询。

    3. 群组被删除后还会在列表中存在 30 天左右,之后会被清理出列表。

恢复群组

  1. 群组管理页面,选择已删除的群组,在操作列单击恢复群组

  2. 在弹出的对话框中,单击确定

    说明
    • 群组被删除后会在列表中保存30天,在此期间您可恢复此群组继续使用,若30天内未进行恢复将会永久删除。

    • 群组恢复后,被删除之前存储的消息依旧可以查询。

更多介绍

消息优先级

在直播间等应用场景中,每个用户可能会频繁发送消息,这将导致群组消息的并发量非常大。当上行消息达到频控阈值时,后台将丢弃部分消息,以确保系统的稳定运行。实际上,当消息在客户端的到达频率过高时,消息的可读性会明显降低,因此对群组消息进行频控是非常必要的。

群组消息分为 3 个优先级,如果某个群的消息超过了频率限制,后台将优先下发高优先级的消息。因此,用户应根据消息的重要程度选择合适的优先级。 这三个优先级从高到低,分别如下:

优先级

建议选择该优先级的消息类型

HIGH

红包、礼物等重要消息。

MEDIUM

弹幕等普通文本消息。

NORMAL

点赞消息。

消息分级限流

当单个群的所有用户每秒发送的消息数超过一定限制(默认50条/秒)时,后台将丢弃部分消息,并优先下发优先级较高的消息。然而,针对不同类型的消息,系统将确保在5秒的时间间隔内下发该类型消息中最新的一条,以防止低优先级的消息因分级限流而1条都没有下发。

被频控限制的消息,不会下发,不缓存也不存储,但会给发送者返回发送成功;

高优先级消息

设置消息分级为HIGH级别时,除了在因消息并发量过大而采取限流策略时具备优先下发权外,还具备高可靠性的属性,即当某个用户因网络等原因导致掉线时,可能会错失部分群消息。当该用户通过SDK的重连恢复机制恢复上线后,SDK内部会自动请求拉取恢复丢失的高优先级消息。

超级大群

对于超级大群(超过2000人的群组),不再提供成员列表查询功能。群成员进出群组的通知之间将至少间隔5秒,通知中不会显示全部进出用户列表,但会显示准确的群人数。一旦群组升级为超级大群,群成员列表将立即清空,且无法再恢复为普通群组,直到所有群成员退出群组(群组关闭),在重新开启时才会恢复为普通群组。