适用场景

在同一个房间内，大量用户需要同时参与音视频互动，例如以下场景。

云端会议单个 RTC 房间内总人数达上千人，所有参会者均可参与音视频互动，即，随时开麦发言、开启摄像头，并自由选择观看其他参会人的视频画面。
互动娱乐在纯语音语聊房场景中，单个 RTC 房间内总人数可高达上万人，其中，台上互动嘉宾人数超 500 人。观众也可以通过需要开麦权限，上台和嘉宾进行音视频互动。

功能变更日志

RTC SDK 3.39.1 版本开始支持本功能
2023 年 6 月 8 日起，RTC 不再区分房间模式，只区分是否开启音频选路。
如果此前你已经在控制台开启相关配置，后台会自动为你切换到对应的配置。你也可以在下表中查看变更前后的配置对应关系。

变更前	普通模式（不开启音频选路）	普通模式（开启音频选路）	大会模式	大会模式 - 游戏场景
变更后	不开启音频选路	开启音频选路	开启音频选路	不开启音频选路

前提条件

你已经集成 3.39.1 或更高版本的 RTC SDK，实现了基本的音视频通话。

功能描述

音频选路：当同时参与音视频互动的嘉宾较多时，建议开启音频选路功能。此后，房间中用户的音频订阅关系交由 RTC 智能托管，无需在客户端手动维护，RTC 将智能决策出房间中音量较大的部分用户，并将这些用户的音频流发送给房间内的其他用户。
开启音频选路后，用户和媒体流容量也会提升，详见用户和媒体流上限。

说明：开启音频选路时
视频订阅关系仍需要在客户端自行维护。
支持取消订阅对方音频。例如， A 取消订阅 B 的音频，那么，即使 B 的音频被选为活跃用户并推送，A 也不会收听到 B 的音频。

开启音频选路

进入控制台，创建 RTC 应用。应用创建成功后，音频选路默认为关闭状态。

说明：我们推荐使用不同的 appID 开发适用于不同场景的音视频应用。是否开启音频选路的应用场景差别较大，尽量避免在用户使用时进行切换。

进入功能配置 > 房间模式，选择刚创建好的应用，开启音频选路。

说明：音频选路启动后，可以按照上述步骤重新切换回普通模式。

音频选路下的 API 和回调

音频选路功能开启后，以下 API 和回调的预期行为有如下变化。

说明：不同平台的实现步骤相同，但接口名称、参数名称可能略有差异。以下指南以 Windows RTC SDK 为例，参考对应平台的 API 文档获取更多信息。

	关闭音频选路	开启音频选路
joinRoom (isAutoSubscribeAudio = true)	自动订阅音频	无效。音频订阅关系由RTC系统智能托管
subscribeStream	订阅指定用户音视频流	视频：与关闭音频选路时相同音频：无需调用。音频订阅关系由RTC系统智能托管。

回调
在音频选路功能开启时，部分回调的行为将发生变化，具体如下表。你需要根据这些变化，调整相应的应用端逻辑。

	关闭音频选路	开启音频选路
onUserJoined	远端可见用户加入房间，或房内不可见用户切换为可见的回调。	房间内可见用户数 >500 后，该回调不触发如果你需要完整的房间内用户名单，需要自行维护用户列表。
onUserLeave	远端可见用户下线或转为隐身	房间内可见用户数 >500 后，该回调不触发
OnRoomStats	2 s 一次的房间内通话统计信息回调	房间内可见用户数 >500 后，回调的 RtcRoomStats{user_count} 值无效
onUserPublishStream	房间内新增远端摄像头/麦克风采集的媒体流回调	只能收到视频流触发的相关回调
onUserUnpublishStream	远端用户取消发布回调	只能收到视频流触发的相关回调
onUserPublishScreen	房间内新增屏幕共享流回调	只能收到视频流触发的相关回调
onUserUnpublishScreen	远端用户取消发布屏幕共享流回调	只能收到视频流触发的相关回调
onNetworkQuality	报告房间内用户的网络质量评分	回调有视频流的用户信息或远端活跃用户的网络质量评分
onRemoteStreamStats	订阅的远端用户发布的流在周期内的网络质量信息。	回调有视频流的用户信息或远端活跃用户的音频流传输信息。
onRemoteAudioPropertiesReport	订阅的远端用户的音频信息。	只回调远端活跃用户的音频信息。

注意事项

房间内媒体流数量到达上限后，调用 PublishStream 或 PublishScreen 将返回 -1080 错误码
当前用户的订阅流数量到达上限后，调用 SubscribeStream 或 SubscribeScreen 将返回-1070 错误码

如有其他问题，请联系咨询售前或技术支持团队。