You need to enable JavaScript to run this app.
导航
实时音视频
  • 文档首页
    • /实时音视频/实时音视频/常见问题/微信小程序 SDK 相关/微信小程序 SDK 媒体能力上限
微信小程序 SDK 媒体能力上限
最近更新时间：2025.08.13 18:08:41首次发布时间：2023.07.10 21:21:50
复制全文
我的收藏
有用
有用
无用
无用

由于平台限制，微信小程序 SDK 的媒体能力与其他端存在差异。

不支持的功能

同一房间用户数上限

说明：可见用户可以发布和订阅媒体流。不可见用户只能订阅媒体流。进房后默认为可见用户，调用 setUserVisibility 切换用户身份。

项目上限
单房间小程序端可见用户数8
单房间小程序不可见用户数10000

同一房间用户进房通知上限

此限制决定了小程序端能够感知并订阅的远端用户范围。

  • 限制规则：对于小程序端用户，RTC 服务端最多只向其下发 20 个在线远端用户的 PEER_ONLINE（用户在线）事件。超出部分的用户将被服务端直接忽略，小程序客户端不会收到对应的事件通知，也不可订阅其流（流订阅依赖于 PEER_ONLINE 事件）。
  • 通知顺序：按房间内用户的历史进房时间顺序（先进房、先通知）下发。当“20人可见名单”中的用户离开房间时，会释放出名额。服务端会从此前被忽略的用户中，按其进房顺序选择一位，向该小程序端补发其 PEER_ONLINE 通知。

示例

  1. 初始状态：一个房间内按顺序已加入了 22 位用户（用户 1~22）。此时，用户 A 以小程序端身份加入。

    结果：用户 A 只会收到用户 1~20 的进房通知。用户 21、22 对其不可见，无法订阅。

  2. 有用户离开：可见名单中的用户 10 离开房间。

    结果: 用户A 收到用户 10 的离开通知，其可见名单出现一个空位。服务端检测到空位后，向用户 A 补发用户 21 的进房通知，用户 A 可以看到用户 21 并可以订阅其流。但用户 22 对 A 依然不可见。

同一房间内同时可订阅媒体流数量上限

  • 在同一房间内，所有在线的小程序用户（无论平台）最多可同时订阅 8 路媒体流。
  • 其中，对于单个 Android 小程序端用户，个人最多可同时订阅 6 路媒体流。

例如，房间内有 20 路流，小程序端用户订阅情况如下：

用户订阅的流
用户 A（Android 小程序端）订阅流 1、2、3、4、5、6
用户 B订阅流 3、4、5、6、7
用户 C订阅流 6、7、8

  • 如果用户 C 需要订阅流 9，由于房间内小程序端用户同时订阅流数已经达到 8 路，此时，对流 9 的订阅会失败。

  • 如果用户 A，需要订阅流 7，由于用户 A 同时订阅流数已经达到 6 路，此时，对流 7 会失败。