# 音强选流 (/zh-CN/realtime-media/rtc/build/audio/audio-stream-filter) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). <_PlatformTabsGroup> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="android" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流] 如果用户希望自己的音频流不参与选流,无论其声音大小都需要传输至接收端时,你可以选择下列其中一种方式来设置: - 调用 [`joinChannel`[2/2]](/zh-CN/api-reference/rtc/android/channel#api_irtcengine_joinchannel2) 或 [`joinChannelWithUserAccount`[2/2]](/zh-CN/api-reference/rtc/android/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/android/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`setParameters`](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息] ### API 参考 [#api-参考] - [`joinChannel`[2/2]](/zh-CN/api-reference/rtc/android/channel#api_irtcengine_joinchannel2) - [`joinChannelWithUserAccount`[2/2]](/zh-CN/api-reference/rtc/android/channel#api_irtcengine_joinchannelwithuseraccount2) - [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/android/channel#api_irtcengine_updatechannelmediaoptions) - [`setParameters`](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="ios" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理-1] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-1] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-1] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流-1] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流-1] 如果你希望自己的音频流不参与选流,即无论其声音大小都需要传输至接收端,你可以选择下列方式之一进行设置: - 调用 [`joinChannelByToken`[2/4]](/zh-CN/api-reference/rtc/ios/channel#api_irtcengine_joinchannel2) 或 [`joinChannelByToken`[4/4]](/zh-CN/api-reference/rtc/ios/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `mediaOptions` 参数将 `AgoraRtcChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`updateChannelWithMediaOptions`](/zh-CN/api-reference/rtc/ios/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `mediaOptions` 参数将 `AgoraRtcChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`setParameters`](/zh-CN/api-reference/rtc/ios/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息-1] ### API 参考 [#api-参考-1] - [`joinChannelByToken`[2/4]](/zh-CN/api-reference/rtc/ios/channel#api_irtcengine_joinchannel) - [`joinChannelByToken`[4/4]](/zh-CN/api-reference/rtc/ios/channel#api_irtcengine_joinchannelwithuseraccount2) - [`updateChannelWithMediaOptions`](/zh-CN/api-reference/rtc/ios/channel#api_irtcengine_updatechannelmediaoptions) - [`setParameters`](/zh-CN/api-reference/rtc/ios/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="macos" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理-2] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-2] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-2] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流-2] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流-2] 如果你希望自己的音频流不参与选流,即无论其声音大小都需要传输至接收端,你可以选择下列方式之一进行设置: - 调用 [`joinChannelByToken`[2/4]](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_joinchannel2) 或 [`joinChannelByToken`[4/4]](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `mediaOptions` 参数将 `AgoraRtcChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`updateChannelWithMediaOptions`](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `mediaOptions` 参数将 `AgoraRtcChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`setParameters`](/zh-CN/api-reference/rtc/macos/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息-2] ### API 参考 [#api-参考-2] - [`joinChannelByToken`[2/4]](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_joinchannel) - [`joinChannelByToken`[4/4]](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_joinchannelwithuseraccount2) - [`updateChannelWithMediaOptions`](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_updatechannelmediaoptions) - [`setParameters`](/zh-CN/api-reference/rtc/macos/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="web" /> 在多个用户同时发流的场景中(如大型会议),订阅所有远端用户的音频流会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 ::: ## 技术原理 [#技术原理-3] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-3] 在进行操作之前,请确保你已经参考[快速开始](/zh-CN/realtime-media/rtc/get-started/quick-start)在项目中实现了基本的实时音视频功能。 ## 实现方法 [#实现方法-3] 本节介绍常见业务场景下音强选流功能的应用。 ### 接收端启用音强选流 [#接收端启用音强选流] 开启音强选流功能后,当前频道内所有被订阅的音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn/)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 发送端设置是否参与音强选流 [#发送端设置是否参与音强选流] 如果用户希望自己发送的音频流不参与选流,即无论其声音大小都需要传输至接收端,请[联系技术支持](https://ticket.shengwang.cn/)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 4,即在接收端订阅的音频流中选出音量最大的 4 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 B、C、D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流](https://web-cdn.agora.io/docs-files/1665472394773) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="windows" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理-4] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-4] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-4] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流-3] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流-3] 如果用户希望自己的音频流不参与选流,无论其声音大小都需要传输至接收端时,你可以选择下列其中一种方式来设置: - 调用 [`joinChannel`[2/2]](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#api_irtcengine_joinchannel2) 或 [`joinChannelWithUserAccount`[2/2]](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`setParameters`](/zh-CN/api-reference/rtc/cpp-all-platforms/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息-3] ### API 参考 [#api-参考-3] - [`joinChannel`[2/2]](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#api_irtcengine_joinchannel2) - [`joinChannelWithUserAccount`[2/2]](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#api_irtcengine_joinchannelwithuseraccount2) - [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#api_irtcengine_updatechannelmediaoptions) - [`setParameters`](/zh-CN/api-reference/rtc/cpp-all-platforms/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="electron" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理-5] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-5] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-5] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流-4] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流-4] 如果用户希望自己的音频流不参与选流,无论其声音大小都需要传输至接收端时,你可以选择下列其中一种方式来设置: - 调用 [`joinChannel`](/zh-CN/api-reference/rtc/electron/channel#api_irtcengine_joinchannel2) 或 [`joinChannelWithUserAccount`](/zh-CN/api-reference/rtc/electron/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/electron/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`setParameters`](/zh-CN/api-reference/rtc/electron/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息-4] ### API 参考 [#api-参考-4] - [`joinChannel`](/zh-CN/api-reference/rtc/electron/channel#api_irtcengine_joinchannel2) - [`joinChannelWithUserAccount`](/zh-CN/api-reference/rtc/electron/channel#api_irtcengine_joinchannelwithuseraccount2) - [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/electron/channel#api_irtcengine_updatechannelmediaoptions) - [`setParameters`](/zh-CN/api-reference/rtc/electron/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="unity" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理-6] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-6] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-6] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流-5] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流-5] 如果你希望自己的音频流不参与选流,即无论其声音大小都需要传输至接收端,你可以选择下列方式之一进行设置: - 调用 [`JoinChannel`[2/2]](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_joinchannel2) 或 [`JoinChannelWithUserAccount`[2/2]](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`UpdateChannelMediaOptions`](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`SetParameters`](/zh-CN/api-reference/rtc/unity/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息-5] ### API 参考 [#api-参考-5] - [`JoinChannel`[2/2]](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_joinchannel2) - [`JoinChannelWithUserAccount`[2/2]](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_joinchannelwithuseraccount2) - [`UpdateChannelMediaOptions`](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_updatechannelmediaoptions) - [`SetParameters`](/zh-CN/api-reference/rtc/unity/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="flutter" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理-7] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-7] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-7] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流-6] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流-6] 如果用户希望自己的音频流不参与选流,无论其声音大小都需要传输至接收端时,你可以选择下列其中一种方式来设置: - 调用 [`joinChannel`](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 或 [`joinChannelWithUserAccount`](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`setParameters`](/zh-CN/api-reference/rtc/flutter/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息-6] ### API 参考 [#api-参考-6] - [`joinChannel`](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) - [`joinChannelWithUserAccount`](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannelwithuseraccount2) - [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_updatechannelmediaoptions) - [`setParameters`](/zh-CN/api-reference/rtc/flutter/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="react-native" /> 默认情况下,用户加入频道后会默认订阅所有远端用户的音频流。但在多个用户同时发流的场景中(如大型会议),这会占用接收端较大的带宽及系统资源。为减少接收端下行带宽压力及系统资源消耗,声网推出音强选流功能。 :::info[信息] 如需启用该功能,请[联系技术支持](https://ticket.shengwang.cn)。 ::: ## 技术原理 [#技术原理-8] 音强选流是指声网服务器根据音强算法对接收端订阅的音频流进行选流,选出 N 路音量最大的音频流传输至接收端。N 支持自定义设置,默认为 3 路。为灵活适应各种业务场景,声网还支持发流端自定义设置其发布的音频流不参与音强选流,直接传输到接收端。 ## 前提条件 [#前提条件-8] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-8] 本节介绍常见业务场景下音强选流功能的应用。 ### 仅启用音强选流 [#仅启用音强选流-7] 开启音强选流功能后,当前频道内的所有音频流默认均会参与选流,声网服务器默认传输实时音量最大的 3 路音频流至接收端。如果你需要自定义传输的音频流的数量 (N),请[联系技术支持](https://ticket.shengwang.cn)。当你自定义 N 后,声网服务器会根据你的设置选出 N 路音量最大的音频流进行传输。在几十人甚至上百人同时发流的场景下,启用音强选流可帮助减小接收端的下行带宽资源压力。 ### 自定义设置是否参与音强选流 [#自定义设置是否参与音强选流-7] 如果用户希望自己的音频流不参与选流,无论其声音大小都需要传输至接收端时,你可以选择下列其中一种方式来设置: - 调用 [`joinChannel`](/zh-CN/api-reference/rtc/react-native/channel#api_irtcengine_joinchannel2) 或 [`joinChannelWithUserAccount`](/zh-CN/api-reference/rtc/react-native/channel#api_irtcengine_joinchannelwithuseraccount2) 加入频道,通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 - 在加入频道后调用 [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/react-native/channel#api_irtcengine_updatechannelmediaoptions),然后通过 `options` 参数将 `ChannelMediaOptions` 中的 `isAudioFilterable` 设为 `false`。 此外,如果某一个接收端希望其接收的音频流不受音强选流功能控制,需要拉取所有订阅的远端音频流,可以调用 [`setParameters`](/zh-CN/api-reference/rtc/react-native/network#api_irtcengine_setparameters) 方法通过 JSON 选项进行设置,详情请[联系技术支持](https://ticket.shengwang.cn)。 **场景示例** 在大型企业会议场景下启用音强选流,同时某些会议关键人物指定其发布的音频流不参与选流,直接传输至接收端。 假设接入频道的人数为 500 人,N 设置为 2,即在接收端订阅的音频流中选出音量最大的 2 路音频流并传输至接收端,同时总部发言代表 A 及其他分支机构发言代表 D 将其发布的音频流设为不参与选流。设置之后可降低接收端播放音频流的卡顿率。同时,对于某些重要的发流用户,即便其说话音量较低,接收端依然可以收到其音频流。 ![音强选流示例图](https://web-cdn.agora.io/docs-portal/img/rtc/audio-stream-filter.png) ## 参考信息 [#参考信息-7] ### API 参考 [#api-参考-7] - [`joinChannel`](/zh-CN/api-reference/rtc/react-native/channel#api_irtcengine_joinchannel2) - [`joinChannelWithUserAccount`](/zh-CN/api-reference/rtc/react-native/channel#api_irtcengine_joinchannelwithuseraccount2) - [`updateChannelMediaOptions`](/zh-CN/api-reference/rtc/react-native/channel#api_irtcengine_updatechannelmediaoptions) - [`setParameters`](/zh-CN/api-reference/rtc/react-native/network#api_irtcengine_setparameters) <_PlatformProcessedMarker close="true" />