Android audio系统六 AudioEffect音效加载

对于Android系统智能硬件设备，音效处理的实现方式有以下几种：
AudioEffect – android系统音效处理
优点：纯软件实现，移植调试简单方便
缺点：cpu上运行，容易因为资源竞争而出现卡顿

DSP/ADSP – 数字信号处理芯片
优点：处理速度快。可以搭载大型算法、AI智能算法
缺点：成本增加，dsp移植调试复杂一些

smartpa/codec/AMP – 功放芯片
优点：硬件处理，速度快，只需要配置寄存器就能实现
缺点：只能支持codec本身支持的算法

AudioEffect – android系统音效处理

1. AudioEffect 框架概述

Android 的 AudioEffect 是音频后处理的核心框架，用于实现均衡器（EQ）、虚拟器（Virtualizer）、重低音（BassBoost）等音效。其架构如下：

应用层 (AudioEffect API)↓
Java/Kotlin (android.media.audiofx.*)↓
JNI 层 (android_media_AudioEffect.cpp)↓
Native 层 (AudioEffect.cpp / Effect.cpp)↓
AudioFlinger (EffectChain / EffectHandle)↓
HAL 层 (audio_effects.conf / 厂商实现)

2. 使用 Android 标准音效

(1) 确认系统是否支持
检查 /vendor/etc/audio_effects.xml 或 /vendor/etc/audio_effects.conf，确认是否已实现以下音效：

<effects><effect name="bassboost" library="libbundlewrapper.so"/><effect name="virtualizer" library="libdownmix.so"/><effect name="equalizer" library="libqcomvoiceprocessing.so"/>
</effects>

（2）在App中调用音效

// 初始化 BassBoost
BassBoost bassBoost = new BassBoost(0, audioSessionId);
bassBoost.setStrength((short) 50);
bassBoost.setEnabled(true);// 初始化 Equalizer
Equalizer equalizer = new Equalizer(0, audioSessionId);
equalizer.setBandLevel((short) 0, (short) 100); // 设置频段增益

3. 集成第三方音效库

(1) 配置 audio_effects.xml

<effects><effect name="dolby_atmos" library="libdolbyeffect.so" uuid="..."/>
</effects>

（2）实现 Effect HAL 接口
在 audio_effects_hal.cpp 中注册音效：

static const struct effect_interface_s dolby_effect_interface = {.process = dolby_process,.command = dolby_command,.get_descriptor = dolby_get_descriptor,
};const effect_descriptor_t dolby_descriptor = {.type = EFFECT_UUID_DOLBY_ATMOS,.uuid = DOLBY_EFFECT_UUID,.apiVersion = EFFECT_CONTROL_API_VERSION,.name = "Dolby Atmos",
};

（3）在 AudioPolicy 中启用
修改 audio_policy_configuration.xml，确保音效可绑定到指定流：

<effects><effect name="dolby_atmos" stream="AUDIO_STREAM_MUSIC"/>
</effects>

4. 自定义音效 HAL

(1) 实现音效处理模块

// custom_effect.cpp
int custom_effect_process(effect_handle_t self, audio_buffer_t *in, audio_buffer_t *out) {// 实现音效算法（如 FIR 滤波、动态范围控制）for (size_t i = 0; i < in->frameCount; i++) {out->s16[i] = in->s16[i] * gain; // 示例：简单增益调节}return 0;
}

（2）注册到 AudioFlinger
在 audio_effects.conf 中声明：

libraries {custom_effect {path /vendor/lib/soundfx/libcustomeffect.so}
}effects {custom_effect {library custom_effectuuid 12345678-1234-5678-1234-567812345678}
}

（3）绑定到音频流
修改 audio_policy_configuration.xml，确保音效可绑定到指定流：

<attachEffect stream="AUDIO_STREAM_MUSIC" effect="custom_effect"/>

5. 调试与验证

检查音效是否加载

# 检查Effect Chains信息
adb shell dumpsys media.audio_flinger

DSP/ADSP – 数字信号处理芯片

本次针对qcom audioReach架构，分析音效移植过程。

1. 拿到音效demo

从算法侧拿到算法库demo，分解关键函数：

init()
process()
setParam()
getParam()
end()

2. 匹配qcom ADSP架构模板

参考qcom算法移植文档 ：
audioreach_spf_common_audio_interface_capi…

smartpa/codec/AMP – 功放芯片

根据芯片手册配置寄存器即可，EQ/DRC/滤波器…