限制说明

更新时间：2025-07-31 18:12

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

房间

ZEGO 房间服务支持单房间百万用户同时在线，默认每个房间的所有用户登录 QPS 总和为 200，即每秒内最多可支持 200 个用户登录同一房间。

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

SDK 接口	大小限制	发送频率限制（SDK 下的单个房间内）	说明
发送广播消息 sendBroadcastMessage	消息长度默认限制为 1 KB。如需发送 1 KB 以上的消息，请联系 ZEGO 技术支持配置。	10 次/s	消息可靠。单个用户在客户端调用此接口的最大 QPS 为 2。向同一房间内所有用户发送广播消息，房间内所有用户都能收到消息。
发送弹幕消息 sendBarrageMessage	消息长度默认限制为 1 KB。如需发送 1 KB 以上的消息，请联系 ZEGO 技术支持配置。	20 次/s	消息不保证可靠。
发送自定义信令消息 sendCustomCommand	消息长度不能超过 1 KB。	向单人发送时：200 条/s 向多人发送时：10 条/s	消息可靠。向同一房间内的所有用户发送自定义消息，房间内所有用户都能收到消息。

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

SDK 接口	大小限制	发送频率限制（SDK 下的单个房间内）	说明
设置房间附加信息 setRoomExtraInfo	key：房间附加消息 key 值，不能超过 10 B，且不允许为空字符串，一个房间内只允许设置 1 个 key 类型。 value：房间附加信息内容，不能超过 128 B，允许为空字符串。	10 次/s	单个用户在客户端多次调用此接口时，再次调用前，请确保已成功收到了前一次接口调用的回调通知。