muteAllPlayStreamAudio method
- bool mute
拉流是否接收所有音频数据。
支持版本:2.4.0 及以上。 详情描述:在实时音视频互动过程中,本地用户可根据需要,通过此函数控制拉流时是否接收所有远端用户的音频数据(包括在调用该函数后新加入房间的用户所推的音频流)。默认情况下,用户加入房间后可以接收所有远端用户推送的音频数据。当开发者不接收音频收据时,可降低硬件和网络的开销 业务场景:当开发者需要快速关闭、恢复远端音频时,可调用此函数。相比重新拉流,能极大降低耗时,提升互动体验。 调用时机:在调用 createEngine 后可调用此函数。 注意事项:此接口在 SDK 生命周期内不能和 muteAllPlayAudioStreams 混用。 相关接口:可调用 mutePlayStreamAudio 函数控制是否接收单条音频数据。必须当 muteAllPlayStreamAudio 和 mutePlayStreamAudio 两个函数同时设置为 "false" 时,本地用户拉流时才能接收远端用户的音频数据:1. 当调用 muteAllPlayStreamAudio(true) 函数时,全局生效,即本地用户会禁止接收所有远端用户的音频数据,此时无论在 muteAllPlayStreamAudio 之前还是之后调用 mutePlayStreamAudio 函数都不生效。 2. 当调用 muteAllPlayStreamAudio(false) 函数时,本地用户可以接收所有远端用户的音频数据,此时可再通过 mutePlayStreamAudio 函数控制是否接收单条音频数据。调用 mutePlayStreamAudio(true, streamID) 函数则本地用户可以接收该 "streamID" 之外的其他音频数据;调用 mutePlayStreamAudio(false, streamID) 函数则本地用户可以接收 "streamID" 的音频数据。
mute
拉流时是否可以接收所有远端用户的音频数据,“true” 表示禁止,“false” 表示接收,默认值为 “false”。
Implementation
Future<void> muteAllPlayStreamAudio(bool mute) async {
return await ZegoExpressImpl.instance.muteAllPlayStreamAudio(mute);
}