实时音视频
  • iOS
  • Android : Java
  • macOS
  • Windows
  • HarmonyOS
  • Linux
  • Web
  • 小程序
  • Flutter
  • Electron
  • Unity3D
  • uni-app
  • React Native
  • Cocos Creator
  • 产品简介
  • 下载
  • 体验 App
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现视频通话
    • 实时音视频 SDK 与实时语音 SDK 差异
    • 场景化音视频配置
  • 基础功能
  • 进阶功能
  • 最佳实践
  • 常见错误码
  • 服务端 API
  • 客户端 API
  • 常见问题

限制说明

更新时间: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 人后,该房间升级为大房间,此时:

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

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

        3 房间附加信息

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