低接入门槛把更多精力放在业务体验上。本文将以 ZEGO 官方 SDK 文档为基础围绕「音频 3A 处理」梳理完整接入流程帮助开发者理解环境准备、初始化、核心 API 调用、媒体处理和常见问题排查。说明本文基于最新版本的官方接入文档整理对部分接入流程和配置方式进行了更新。功能简介在实时音视频通话或直播时可以对音频进行 3A 处理主要包括 AECAcoustic Echo Cancelling回声消除、AGCAutomatic Gain Control自动增益控制和 ANSActive 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);设置 AGC自动增益控制注意enableAGC 需要在 startPublishingStream、startPlayingStream、startPreview、createMediaPlayer、createAudioEffectPlayer 和 createRealTimeSequentialDataManager 这些接口之前调用才有效。// 开启 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);相关文档怎么处理音频回声问题怎么处理音频噪声问题如何获取、上传音频的 Dump 文件结语本文主要介绍了「音频 3A 处理」的基础接入流程并结合官方文档梳理了环境准备、核心 API 调用、媒体处理和结果验证等关键环节。通过这类能力开发者可以更快搭建实时音视频、在线互动、远程协作、直播连麦、视频通话等典型场景并在后续根据业务需要扩展更多互动能力。围绕实时音视频能力后续还可以继续关注RTC SDK 完整接入流程与关键参数配置推流、拉流、房间与回调机制解析权限、Token、设备兼容和网络异常排查多人通话、语聊房、互动直播等进阶场景跨端场景下的实时互动能力对比本系列将围绕「RTC SDK 接入与实时互动能力实现」持续更新适合需要构建实时音视频、在线互动、AI 实时通信等能力的开发者参考。常见问题1. 音频 3A 处理中的 AEC、AGC、ANS 分别解决什么问题AEC 主要用于回声消除减少采集音频中的回声AGC 用于自动增益控制让麦克风音量在远近拾音时保持相对稳定ANS 用于噪声抑制识别并削弱背景噪声使人声更清晰。2. AEC、AGC、ANS 相关接口应该在什么时候调用文档中强调AEC、AGC、ANS 相关配置需要在推流、拉流、预览、创建媒体播放器、创建音效播放器以及创建实时有序数据管理器等接口之前调用才能确保配置生效。3. ZegoAECMode.AGGRESSIVE、MEDIUM、SOFT 应该怎么选