限制说明

更新时间：2022-11-14 10:34

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

1 房间

ZEGO 房间服务支持单房间百万用户同时在线，默认每个房间的所有用户登录 QPS 总和为 200，即每秒内最多可支持 200 个用户登录同一房间。
当房间人数超过 500 人时，部分用户加入/退出房间的通知（onRoomUserUpdate）无法正常接收，建议开发者在自己的业务服务器维护房间用户的列表：
- 前 500 人将无法收到 500 人以外的用户加入/退出房间的通知；
- 500 人以外的用户无法收到房间内任何用户加入/退出房间的通知（前 500 人可正常收到彼此的通知）。

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

2 房间实时消息

SDK 接口名	接口描述	大小限制	发送频率限制（SDK 下的单个房间内）	备注
sendBroadcastMessage	广播消息	如果接入 2.12.0（2020-09-09 发布）及以上版本的 SDK，支持发送长度更大的消息（默认限制为 1 KB），如需发送 1 KB 以上的消息，请联系 ZEGO 技术支持配置。如果接入 1.12.3（2020-08-06 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。如果接入 1.12.3 以下版本的 SDK，则消息长度不能超过 512 B。	10 次/s	消息可靠。单个用户在客户端调用此接口的最大 QPS 为 2。当房间人数小于 500 人时，向同一房间内所有用户发送广播消息，房间内所有用户基本都能收到消息。当房间人数超过500人后，该房间升级为大房间，此时，广播消息将不再可靠，且就算房间人数再次小于500人了，房间内的广播消息也仍然不再可靠，除非所有人退出房间，重新创建房间才可恢复。
sendBarrageMessage	弹幕消息	如果接入 2.12.0（2020-09-09 发布）及以上版本的 SDK，支持发送长度更大的消息（默认限制为 1 KB），如需发送 1 KB 以上的消息，请联系 ZEGO 技术支持配置。如果接入 1.12.3（2020-08-06 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。如果接入 1.12.3 以下版本的 SDK，则消息长度不能超过 512 B。	20 次/s	消息不保证可靠
sendCustomCommand	自定义信令	如果接入 1.12.3（2020-08-06 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。如果接入 1.12.3 以下版本的 SDK，则消息长度不能超过 512 B。	向单人发送时：200 条/s 向多人发送时：10 条/s	消息可靠。当房间人数小于 500 人时，向同一房间内所有用户发自定义消息，房间内所有用户基本都能收到消息；当房间人数大于 500 人后，该房间升级为大房间，此时：若对升级大房间后进来的某个用户发自定义消息，将不会成功若对升级大房间之前进来的某个用户发消息，会成功。若对房间内所有用户发自定义消息，将不再可靠。除非所有人退出房间，重新创建房间，才可恢复正常。

SDK 接口名

接口描述

大小限制

发送频率限制
（SDK 下的单个房间内）

备注

sendBroadcastMessage

广播消息

如果接入 2.12.0（2020-09-09 发布）及以上版本的 SDK，支持发送长度更大的消息（默认限制为 1 KB），如需发送 1 KB 以上的消息，请联系 ZEGO 技术支持配置。
如果接入 1.12.3（2020-08-06 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。
如果接入 1.12.3 以下版本的 SDK，则消息长度不能超过 512 B。

10 次/s

消息可靠。

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

当房间人数小于 500 人时，向同一房间内所有用户发送广播消息，房间内所有用户基本都能收到消息。

当房间人数超过500人后，该房间升级为大房间，此时，广播消息将不再可靠，且就算房间人数再次小于500人了，房间内的广播消息也仍然不再可靠，除非所有人退出房间，重新创建房间才可恢复。

sendBarrageMessage

弹幕消息

如果接入 2.12.0（2020-09-09 发布）及以上版本的 SDK，支持发送长度更大的消息（默认限制为 1 KB），如需发送 1 KB 以上的消息，请联系 ZEGO 技术支持配置。
如果接入 1.12.3（2020-08-06 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。
如果接入 1.12.3 以下版本的 SDK，则消息长度不能超过 512 B。

20 次/s

消息不保证可靠

sendCustomCommand

自定义信令

如果接入 1.12.3（2020-08-06 发布）及以上版本的 SDK，则消息长度不能超过 1 KB。
如果接入 1.12.3 以下版本的 SDK，则消息长度不能超过 512 B。

向单人发送时：200 条/s
向多人发送时：10 条/s

消息可靠。

当房间人数小于 500 人时，向同一房间内所有用户发自定义消息，房间内所有用户基本都能收到消息；

当房间人数大于 500 人后，该房间升级为大房间，此时：

若对升级大房间后进来的某个用户发自定义消息，将不会成功
若对升级大房间之前进来的某个用户发消息，会成功。
若对房间内所有用户发自定义消息，将不再可靠。
除非所有人退出房间，重新创建房间，才可恢复正常。

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

3 房间附加信息

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

云通讯产品

低代码互动产品

Meta 元宇宙

扩展服务

Meta 元宇宙

社交娱乐

电商直播

在线教育

医疗健康

互动游戏

协同办公

物联网

限制说明

1 房间

2 房间实时消息

3 房间附加信息