enableHeadphoneAEC method
- bool enable
是否在使用耳机时开启回声消除。
支持版本:1.1.0 及以上。
详情描述:当使用 enableAEC 开启了回声消除后,对于移动端设备来说只在使用扬声器时开启。如果需要在使用耳机时开启或者关闭回声消除,请调用此函数。
业务场景:当移动端设备连接了一个外置声卡作为音频输出源时,为了消除这种情况下的回声,需要调用此函数开启回声消除。
默认值:Android 默认关闭,iOS 默认开启。
调用时机:需要在 createEngine 之后,startPublishingStream
、 startPlayingStream
、 startPreview
、 createMediaPlayer
、 createAudioEffectPlayer
和 createRealTimeSequentialDataManager
之前调用。
注意事项:开启回声消除会增加耳返延迟。在 iOS 平台,SDK 内部无法区分耳机跟外置声卡,如果使用此函数关闭使用耳机时的系统回声消除,则在用户接入外部声卡时会采集外部声卡播放的声音,导致回声问题。
使用限制:无。
相关接口:不使用耳机时可通过 enableAEC 设置 SDK 是否开启回声消除。
平台差异:仅支持 iOS 和 Android。
enable
是否开启;true 表示开启;false 表示关闭。
Implementation
Future<void> enableHeadphoneAEC(bool enable) async {
return await ZegoExpressImpl.instance.enableHeadphoneAEC(enable);
}