限制说明

更新时间：2023-10-30 16:02

本文介绍 ZEGO LiveRoom SDK 及房间服务的使用限制说明，包括频率限制，字符串大小等。

1 房间

如果需要提高限制，请联系 ZEGO 技术支持申请评估。

SDK 接口名	接口描述	大小限制	发送频率限制（整个房间内）	备注
sendRoomMessage	广播消息	如果接入 gbbac93b4e（2020-07-10 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。如果接入 gbbac93b4e 以下版本的 SDK，则消息长度不能超过 512 B。	10 次/s	消息可靠。单个用户在客户端调用此接口的最大 QPS 为 2。房间在线人数超过 500 时不支持。
sendBigRoomMessage	弹幕消息	如果接入 gbbac93b4e（2020-07-10 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。如果接入 gbbac93b4e 以下版本的 SDK，则消息长度不能超过 512 B。	20 次/s	消息不保证可靠。
sendCustomCommand	自定义信令	如果接入 gbbac93b4e（2020-07-10 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。如果接入 gbbac93b4e 以下版本的 SDK，则消息长度不能超过 512 B。	向单人发送时：200 条/s 向多人发送时：10 条/s	消息可靠。房间在线人数超过 500 时，不支持对多人发送。

SDK 接口名

接口描述

大小限制

发送频率限制
（整个房间内）

备注

广播消息

10 次/s

消息可靠。

单个用户在客户端调用此接口的最大 QPS 为 2。

房间在线人数超过 500 时不支持。

弹幕消息

20 次/s

消息不保证可靠。

自定义信令

消息可靠。

房间在线人数超过 500 时，不支持对多人发送。

此处的 消息可靠性 指网络连接正常时，对端用户是否能成功收到消息。

SDK 接口名	接口描述	大小限制	发送频率限制（整个房间内）
setRoomExtraInfo	房间附加信息	key：房间附加消息 key 值，不能超过 10 字节，且不允许为空字符串，一个房间内只允许设置 1 个类型。 value：房间附加信息内容，不能超过 128 字节，允许为空字符串。	10 次/s