在实时音视频通话或直播时,可以对音频进行 3A 处理,主要包括 AEC(Acoustic Echo Cancelling,回声消除),AGC(Automatic Gain Control,自动增益控制)和 ANS(Active Noise Control,降噪),以提高通话或直播质量和用户体验。
如需使用音乐场景检测能力,请联系 ZEGO 技术支持进行特殊编包与配置。
请参考 下载示例源码 获取源码。
相关源码请查看 “/ZegoExpressExample/Examples/AdvancedAudioProcessing/AECANSAGC” 目录下的文件。
在使用音频 3A 处理之前,请确保:
enableAEC 、enableHeadphoneAEC 和 setAECMode 都需要在 startPublishingStream、 startPlayingStream、 startPreview、 createMediaPlayer、createAudioEffectPlayer 和 createRealTimeSequentialDataManager 这些接口之前调用才有效。
开发者可以按照以下步骤完成回声消除相关设置:
调用 enableAEC 接口开启回声消除,该功能开启后,SDK 会对采集到的音频数据进行过滤以减少音频中的回声。
(可选)开发者可通过调用 enableHeadphoneAEC 接口设置是否在使用耳机的时候开启回声消除。
开启回声消除后,开发者可通过调用 setAECMode 接口设置回声消除模式。SDK 支持以下三种回声消除模式:
枚举值 | 说明 |
---|---|
ZegoAECModeAggressive | 激进的回声抵消,可能会比较明显的影响音质,但是回声会消除得很干净。 |
ZegoAECModeMedium | 适度的回声抵消,可能会稍微影响一点点音质,但是残留的回声会更少。 |
ZegoAECModeSoft | 舒适的回声抵消,回声抵消基本不会影响声音的音质,可能有时会残留一点回声,但不会影响正常听音。 |
以设置适度的回声抵消为例:
// 开启 AEC
[[ZegoExpressEngine sharedEngine] enableAEC:YES];
// 在使用耳机时开启 AEC
[[ZegoExpressEngine sharedEngine] enableHeadphoneAEC:YES];
// 设置 AEC 模式为 ZegoAECModeMedium
[[ZegoExpressEngine sharedEngine] setAECMode:ZegoAECModeMedium];
enableAGC 需要在 startPublishingStream、 startPlayingStream、 startPreview、 createMediaPlayer、createAudioEffectPlayer 和 createRealTimeSequentialDataManager 这些接口之前调用才有效。
调用 enableAGC 接口开启自动增益控制,开启该功能后,SDK 能够自动调节麦克风音量,适应远近拾音,保持音量稳定。
// 开启 AGC
[[ZegoExpressEngine sharedEngine] enableAGC:YES];
enableANS 、enableTransientANS 和 setANSMode 都需要在 startPublishingStream、 startPlayingStream、 startPreview、 createMediaPlayer、createAudioEffectPlayer 和 createRealTimeSequentialDataManager 这些接口之前调用才有效。
开发者可以按照以下步骤完成噪声抑制相关设置:
调用 enableANS 接口开启噪声抑制,该功能开启后可以使人声更加清晰。
(可选)开发者可通过调用 enableTransientANS 接口设置是否开启瞬态噪声抑制。瞬态噪声抑制用于抑制敲击键盘、桌子等瞬态噪声。
开启噪声抑制后,开发者可通过调用 setANSMode 接口设置噪声抑制模式,默认值为 “ZegoANSModeMedium”。
SDK 支持以下四种噪声抑制模式:
枚举值 | 说明 |
---|---|
ZegoANSModeAggressive | 激进的噪声抑制,有可能明显损伤音质,但有很好的降噪效果。 |
ZegoANSModeMedium | 适度的噪声抑制,有可能损伤一些音质,但有不错的降噪效果。 |
ZegoANSModeSoft | 轻度的噪声抑制,基本不会损伤音质,但会残留一些噪声。 |
ZegoANSModeAI | AI 模式噪声抑制,会对音乐有较大损伤,可用于处理非稳态噪声,但不能用于需要采集背景音的音源处理,详情请参考 AI 降噪。 |
以设置适度的噪声抑制为例:
// 开启 ANS
[[ZegoExpressEngine sharedEngine] enableANS:YES];
// 开启瞬态噪声抑制
[[ZegoExpressEngine sharedEngine] enableTransientANS:YES];
// 设置 ANS 模式为 ZegoANSModeMedium
[[ZegoExpressEngine sharedEngine] setANSMode:ZegoANSModeMedium];
SDK 中音频 3A 处理的默认配置和推荐配置如下:
接口名称 | 接口描述 | 默认配置 | 推荐配置 |
---|---|---|---|
enableAEC | 开/关回声消除 | 未调用此函数前,SDK 内部会自动判断是否需要使用 AEC,一旦调用此函数,则不再自动判断 | 在一般使用场景中,建议不修改该配置,保持默认即可。 |
enableHeadphoneAEC | 是否在使用耳机时开启回声消除 | Yes | 在普通语聊或游戏开黑时,建议启用该功能,其他情况下一般无需启用。 |
setAECMode | 设置回声消除模式 | ZegoAECModeAggressive(激进的回声抵消) | 在一般使用场景中,建议不修改该配置,保持默认即可。 |
enableAGC | 开/关自动增益控制 | 未调用此函数前,SDK 内部会自动判断是否需要使用 AGC,一旦调用此函数,则不再自动判断 |
|
enableANS | 开/关噪声抑制 | 未调用此函数前,SDK 内部会自动判断是否需要使用 ANS,一旦调用此函数,则不再自动判断 | 在一般使用场景中,建议不修改该配置,保持默认即可。 |
setANSMode | 设置音频噪声抑制模式 | ZegoANSModeMedium(适度的噪声抑制) | 在一般使用场景中,建议不修改该配置,保持默认即可。 |
方法 | 描述 |
---|---|
enableAEC | 开/关回声消除 |
enableHeadphoneAEC | 是否在使用耳机时开启回声消除 |
setAECMode | 设置回声消除模式 |
enableAGC | 开/关自动增益控制 |
enableANS | 开/关噪声抑制 |
enableTransientANS | 开/关瞬态噪声抑制 |
setANSMode | 设置音频噪声抑制模式 |
联系我们
文档反馈