25、Android 12+ AEC新特性：系统级AEC API、AudioManager.setAECEnabled

说实话，Android 12之前做回声消除，咱们开发者基本就两条路：要么自己撸一套AEC算法，要么依赖第三方SDK。我自己在项目里就吃过不少苦头——自己写的算法效果不稳定，第三方SDK又经常跟系统音频策略打架。直到Android 12推出了系统级AEC API，嗯，这算是Google终于把这块短板补上了。

25.1 系统级AEC API是什么？

说白了，就是Google把AEC功能直接集成到了Android音频框架里。你不再需要自己实现回声消除算法，只需要调用AudioManager.setAECEnabled()这个API，系统就会帮你处理回声问题。

我个人习惯把这个API叫做“一键AEC”。为什么？因为它真的就只是一个开关。你传个true进去，系统底层就开始做回声消除；传个false，就关掉。简单粗暴，但效果出奇的好。

// Android 12+ (API level 31+)
public void setAECEnabled(boolean enabled) 
    throws IllegalStateException, SecurityException

这里要注意，这个API是AudioManager的方法，不是AudioRecord的。我刚开始也搞混过，以为要在录音的时候设置，结果找了半天没找到。后来翻文档才发现，它是系统级别的配置。

25.2 使用条件与限制

别高兴太早，这个API不是随便就能用的。它有几个硬性条件：

我曾经在一个项目里踩过坑——明明API调用了，也返回成功了，但回声就是消不掉。查了半天才发现，那台设备压根没有硬件AEC支持。所以，调用之前一定要先检查一下。

25.3 完整使用流程

嗯，这里我给大家整理了一个标准的使用流程。你想想看，其实就三步：检查、设置、验证。

// 1. 获取AudioManager实例
AudioManager audioManager = 
    (AudioManager) getSystemService(Context.AUDIO_SERVICE);

// 2. 检查硬件是否支持AEC
if (audioManager.isAECSupported()) {
    // 3. 设置音频模式为通信模式
    audioManager.setMode(AudioManager.MODE_IN_COMMUNICATION);
    
    // 4. 启用AEC
    try {
        audioManager.setAECEnabled(true);
        Log.d("AEC", "系统级AEC已启用");
    } catch (SecurityException e) {
        Log.e("AEC", "缺少权限: " + e.getMessage());
    } catch (IllegalStateException e) {
        Log.e("AEC", "状态异常: " + e.getMessage());
    }
} else {
    Log.w("AEC", "当前设备不支持硬件AEC");
}

我个人习惯把这段代码封装成一个工具类，每次进入通话场景时调用。这样代码复用性高，也方便统一管理。

25.4 系统级AEC vs 软件AEC

你可能会问：系统级AEC和软件AEC到底哪个好？我直接说结论：系统级AEC在延迟和功耗上完胜。

为什么？因为系统级AEC是在音频DSP（数字信号处理器）上跑的，不占用CPU资源。而软件AEC需要在应用层做音频数据处理，不仅延迟高，还费电。我在一个VoIP项目里做过对比测试：

不过话说回来，系统级AEC也有它的短板——它是个黑盒。你没法调整算法参数，也没法做定制化处理。如果你的应用场景比较特殊（比如需要特殊的非线性处理），那可能还是得用软件方案。

25.5 核心知识体系

为了让你更直观地理解这一章的内容，我画了一张流程图：

25.6 实际项目中的注意事项

最后，我分享几个实际项目中的经验：

• 权限申请时机：MODIFY_AUDIO_SETTINGS 是普通权限，不需要运行时申请。但如果你忘了在Manifest里声明，调用时会直接抛 SecurityException。
• 模式切换：记得在退出通话时把模式切回 MODE_NORMAL，并调用 setAECEnabled(false)。否则可能会影响其他应用的音频行为。
• 兼容性处理：Android 12以下的设备，建议用反射调用或者直接走软件AEC方案。我一般会在代码里做版本判断：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    // 使用系统级AEC
    if (audioManager.isAECSupported()) {
        audioManager.setAECEnabled(true);
    }
} else {
    // 回退到WebRTC AEC或其他软件方案
    initSoftwareAEC();
}

嗯，这一章的内容就到这里。系统级AEC API的出现，确实让Android音频开发省了不少事。但记住，它不是一个万能药——硬件不支持的时候，该自己动手还是得自己动手。