消息群组是指在社交平台或直播互动服务中,为了方便多人之间的信息交流与互动而创建的虚拟集合体。在直播场景下,消息群组能增强观众之间的互动性以及观众与主播之间的互动。
使用说明
使用群组管理前,您必须已经创建互动消息应用。详细信息,请参见创建应用。
单个互动消息应用下最多可创建5000个互动消息群组(已删除的群组不占额度)。
群组被删除后还会在列表中存在大约30天左右,之后会从列表中清理掉。
创建群组
登录视频直播控制台。
在左侧导航栏选择
,进入群组管理页面。选择数据中心和互动消息应用后,单击创建群组。
在创建互动消息群组对话框中,根据实际需求配置参数。
参数
说明
群组ID
创建的群组ID,保证群组ID唯一,由大小写字母、数字组成,长度不超过64字节。
群组名称
群组名,长度不超过128字节。
群主设置
群组创建者ID,由大小写字母、数字组成,长度不超过64字节。
管理员设置
管理员用户ID,由大小写字母、数字组成,长度不超过64字节。多个用半角逗号(,)隔开,最多不超过3个。
群扩展信息
群组扩展信息,最大32K字符。
单击确定,创建互动消息群组。
后续步骤
修改群组配置
在群组管理页面,选择需要修改的群组,在操作列单击查看详情。
在弹出的群组信息面板中,修改相关参数信息即可。
发送消息
在群组管理页面,选择群组,在操作列单击发送消息。
在弹出的发送消息对话框中,根据实际需求配置参数,单击确定。
说明目标群组需要时激活状态,即当前群组中有用户已加入,才能正常往群组发送消息。如果遇到发送消息失败,请先确认当前群组中是否有用户。
参数
说明
发送者ID
发送者ID,由大小写字母、数字组成,长度不超过64字节。
发送者扩展信息
发送消息用户的扩展信息,长度不超过512字节。
消息类型
消息类型需要传入数字。
信息内容
消息体,长度不超过15KB。
删除群组
在群组管理页面,选择需要删除的群组,在操作列单击删除群组。
在弹出的对话框中,单击确定。删除操作不可逆,请谨慎操作。
说明群组删除后,不再可用,正在群组中的所有人,会被通知群已结束。
群组删除后,消息在7天内可查询。
群组被删除后还会在列表中存在 30 天左右,之后会被清理出列表。
恢复群组
在群组管理页面,选择已删除的群组,在操作列单击恢复群组。
在弹出的对话框中,单击确定。
说明群组被删除后会在列表中保存30天,在此期间您可恢复此群组继续使用,若30天内未进行恢复将会永久删除。
群组恢复后,被删除之前存储的消息依旧可以查询。
更多介绍
消息优先级
在直播间等应用场景中,每个用户可能会频繁发送消息,这将导致群组消息的并发量非常大。当上行消息达到频控阈值时,后台将丢弃部分消息,以确保系统的稳定运行。实际上,当消息在客户端的到达频率过高时,消息的可读性会明显降低,因此对群组消息进行频控是非常必要的。
群组消息分为 3 个优先级,如果某个群的消息超过了频率限制,后台将优先下发高优先级的消息。因此,用户应根据消息的重要程度选择合适的优先级。 这三个优先级从高到低,分别如下:
优先级 | 建议选择该优先级的消息类型 |
HIGH | 红包、礼物等重要消息。 |
MEDIUM | 弹幕等普通文本消息。 |
NORMAL | 点赞消息。 |
消息分级限流
当单个群的所有用户每秒发送的消息数超过一定限制(默认50条/秒)时,后台将丢弃部分消息,并优先下发优先级较高的消息。然而,针对不同类型的消息,系统将确保在5秒的时间间隔内下发该类型消息中最新的一条,以防止低优先级的消息因分级限流而1条都没有下发。
被频控限制的消息,不会下发,不缓存也不存储,但会给发送者返回发送成功;
高优先级消息
设置消息分级为HIGH级别时,除了在因消息并发量过大而采取限流策略时具备优先下发权外,还具备高可靠性的属性,即当某个用户因网络等原因导致掉线时,可能会错失部分群消息。当该用户通过SDK的重连恢复机制恢复上线后,SDK内部会自动请求拉取恢复丢失的高优先级消息。
超级大群
对于超级大群(超过2000人的群组),不再提供成员列表查询功能。群成员进出群组的通知之间将至少间隔5秒,通知中不会显示全部进出用户列表,但会显示准确的群人数。一旦群组升级为超级大群,群成员列表将立即清空,且无法再恢复为普通群组,直到所有群成员退出群组(群组关闭),在重新开启时才会恢复为普通群组。