音频 3A 处理

2025-03-05

功能简介

在实时音视频通话或直播时，可以对音频进行 3A 处理，主要包括 AEC（Acoustic Echo Cancelling，回声消除）、AGC（Automatic Gain Control，自动增益控制）和 ANS（Active Noise Control，降噪），以提高通话或直播质量和用户体验。

AEC（回声消除）：对采集到的音频数据进行过滤以减少音频中的回声。
AGC（自动增益控制）：开启该功能后，SDK 能够自动调节麦克风音量，适应远近拾音，保持音量稳定。
ANS（降噪）：识别声音中的背景噪声并进行消除，开启该功能后可以使人声更加清晰。同时您可以开启音乐场景检测，实时无消耗识别通讯和音乐场景，在音乐场景对人声以及音乐的音质进一步保真。如果用户需要更加激进的降噪策略，可使用场景化 AI 降噪功能。

注意

如需使用音乐场景检测能力，请联系 ZEGO 技术支持进行特殊编包与配置。

示例源码下载

请参考下载示例源码获取源码。

相关源码请查看 “/ZegoExpressExample/AdvancedAudioProcessing/src/main/java/im/zego/advancedaudioprocessing/audio3a” 目录下的文件。

默认配置与推荐配置

SDK 中音频 3A 处理的默认配置和推荐配置如下：

接口名称	接口描述	默认配置	推荐配置
enableAEC	开/关回声消除。	未调用此函数前，SDK 内部会自动判断是否需要使用 AEC，一旦调用此函数，则 SDK 不再自动判断。	在一般使用场景中，建议不修改该配置，保持默认即可。
enableHeadphoneAEC	是否在使用耳机时开启回声消除。	不开启。	在普通语聊或游戏开黑时，建议启用该功能，其他情况下一般无需启用。
setAECMode	设置回声消除模式。	ZegoAECMode.AGGRESSIVE（激进的回声抵消）。	在一般使用场景中，建议不修改该配置，保持默认即可。
enableAGC	开/关自动增益控制。	未调用此函数前，SDK 内部会自动判断是否需要使用 AGC，一旦调用此函数，则 SDK 不再自动判断。	在普通语聊场景中，建议使用默认配置。在音乐电台场景中，建议不开启自动增益控制以还原人声。在教育场景中，如大班课、小班课和 1v1 等，建议开启自动增益控制。
enableANS	开/关噪声抑制。	未调用此函数前，SDK 内部会自动判断是否需要使用 ANS，一旦调用此函数，则不再自动判断。	在一般使用场景中，建议不修改该配置，保持默认即可。
enableTransientANS	开/关瞬态噪声抑制。	未调用此函数时，默认不开启瞬态噪声抑制。	在一般使用场景中，建议不修改该配置，保持默认即可。
setANSMode	设置音频噪声抑制模式。	ZegoANSMode.MEDIUM（适度的噪声抑制）。	在一般使用场景中，建议不修改该配置，保持默认即可。

前提条件

在使用音频 3A 处理之前，请确保：

已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 - 项目信息。
已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考快速开始 - 集成和快速开始 - 实现流程。

使用步骤

设置 AEC（回声消除）

注意

enableAEC、enableHeadphoneAEC 和 setAECMode 都需要在 startPublishingStream、startPlayingStream、startPreview、createMediaPlayer、createAudioEffectPlayer 和 createRealTimeSequentialDataManager 这些接口之前调用才有效。

开发者可以按照以下步骤完成回声消除相关设置：

调用 enableAEC 接口开启回声消除，该功能开启后，SDK 会对采集到的音频数据进行过滤以减少音频中的回声。
（可选）开发者可通过调用 enableHeadphoneAEC 接口设置是否在使用耳机的时候开启回声消除。

开启回声消除后，开发者可通过调用 setAECMode 接口设置回声消除模式。SDK 支持以下三种回声消除模式：

枚举值	说明
ZegoAECMode.AGGRESSIVE	激进的回声抵消，可能会比较明显的影响音质，但是回声会消除得很干净。
ZegoAECMode.MEDIUM	适度的回声抵消，可能会稍微影响一点点音质，但是残留的回声会更少。
ZegoAECMode.SOFT	舒适的回声抵消，回声抵消基本不会影响声音的音质，可能有时会残留一点回声，但不会影响正常听音。

注意

Express SDK 支持 AI 回声消除，在有效消除回声基础上，进一步提升人声的保真度。如需使用 AI 回声消除功能，请先联系 ZEGO 技术支持进行特殊编包。

以设置适度的回声抵消为例：

// 开启 AEC
engine.enableAEC(true);
// 在使用耳机时开启 AEC
engine.enableHeadphoneAEC(true);
// 设置 AEC 模式为 ZegoAECMode.MEDIUM
engine.setAECMode(ZegoAECMode.MEDIUM);

// 开启 AEC
engine.enableAEC(true);
// 在使用耳机时开启 AEC
engine.enableHeadphoneAEC(true);
// 设置 AEC 模式为 ZegoAECMode.MEDIUM
engine.setAECMode(ZegoAECMode.MEDIUM);

设置 AGC（自动增益控制）

注意

enableAGC 需要在 startPublishingStream、startPlayingStream、startPreview、createMediaPlayer、createAudioEffectPlayer 和 createRealTimeSequentialDataManager 这些接口之前调用才有效。

调用 enableAGC 接口开启自动增益控制，开启该功能后，SDK 能够自动调节麦克风音量，适应远近拾音，保持音量稳定。

// 开启 AGC
engine.enableAGC(true);

// 开启 AGC
engine.enableAGC(true);

设置 ANS (噪声抑制)

注意

enableANS、enableTransientANS 和 setANSMode 都需要在 startPublishingStream、startPlayingStream、startPreview、createMediaPlayer、createAudioEffectPlayer 和 createRealTimeSequentialDataManager 这些接口之前调用才有效。

开发者可以按照以下步骤完成噪声抑制相关设置：

调用 enableANS 接口开启噪声抑制，该功能开启后可以使人声更加清晰。
（可选）开发者可通过调用 enableTransientANS 接口设置是否开启瞬态噪声抑制，瞬态噪声抑制用于抑制敲击键盘、桌子等瞬态噪声。

开启噪声抑制后，开发者可通过调用 setANSMode 接口设置噪声抑制模式，默认值为 “ZegoANSMode.MEDIUM”。 SDK 支持以下多种噪声抑制模式：

枚举值	说明
ZegoANSMode.AGGRESSIVE	激进的噪声抑制，有可能明显损伤音质，但有很好的降噪效果。
ZegoANSMode.MEDIUM	（默认值）适度的噪声抑制，有可能损伤一些音质，但有不错的降噪效果。
ZegoANSMode.SOFT	轻度的噪声抑制，基本不会损伤音质，但会残留一些噪声。

注意

Express SDK 支持 AI 模式噪声抑制，并提供轻量模式、均衡模式及低延迟模式三种模式，在消除稳态噪声的基础上，有效消除瞬态噪声，如键盘、咳嗽、风声、汽车喇叭等瞬态噪声，详情请参考场景化 AI 降噪。

（可选）开启音乐检测。请联系 ZEGO 技术支持配置开启音乐检测功能。

以设置轻度的噪声抑制为例：

// 开启 ANS
engine.enableANS(true);
// 开启瞬态噪声抑制
engine.enableTransientANS(true);
// 设置 ANS 模式为 ZegoANSMode.SOFT
engine.setANSMode(ZegoANSMode.SOFT);

// 开启 ANS
engine.enableANS(true);
// 开启瞬态噪声抑制
engine.enableTransientANS(true);
// 设置 ANS 模式为 ZegoANSMode.SOFT
engine.setANSMode(ZegoANSMode.SOFT);