互动视频
  • iOS
  • Android : Java
  • macOS
  • Windows
  • Linux
  • Web
  • 小程序
  • Electron
  • 概述
  • 限制说明
  • SDK 下载
  • 快速开始
  • 常用功能
  • 推拉流进阶
  • 视频进阶
  • 音频进阶
  • 其他功能
  • 废弃接口
  • API 文档
  • 常见错误码
  • 常见问题
  • AI教育
  • KTV 合唱
  • 视频直播
  • 视频通话
  • 游戏直播
  • 直播答题
  • 娃娃机

限制说明

更新时间:2021-09-01 10:31

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

1 房间

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

  • 当房间人数超过 500 人时,用户登录/退出的回调以及用户列表的回调将会关闭,建议开发者在自己的业务服务器维护用户列表。

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

2 房间实时消息

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 时,不支持对多人发送。

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

        3 房间附加信息

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