Android audio系统六 AudioEffect音效加载

对于Android系统智能硬件设备，音效处理的实现方式有以下几种：
AudioEffect -- android系统音效处理

优点：纯软件实现，移植调试简单方便

缺点：cpu上运行，容易因为资源竞争而出现卡顿

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

优点：处理速度快。可以搭载大型算法、AI智能算法

缺点：成本增加，dsp移植调试复杂一些

smartpa/codec/AMP -- 功放芯片

优点：硬件处理，速度快，只需要配置寄存器就能实现

缺点：只能支持codec本身支持的算法

AudioEffect -- android系统音效处理

1. AudioEffect 框架概述

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

bash 复制代码

应用层 (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，确认是否已实现以下音效：

xml 复制代码

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

（2）在App中调用音效

java 复制代码

// 初始化 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

xml 复制代码

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

（2）实现 Effect HAL 接口

在 audio_effects_hal.cpp 中注册音效：

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，确保音效可绑定到指定流：

xml 复制代码

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

4. 自定义音效 HAL

(1) 实现音效处理模块

cpp 复制代码

// 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 中声明：

xml 复制代码

libraries {
    custom_effect {
        path /vendor/lib/soundfx/libcustomeffect.so
    }
}

effects {
    custom_effect {
        library custom_effect
        uuid 12345678-1234-5678-1234-567812345678
    }
}

（3）绑定到音频流

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

xml 复制代码

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

5. 调试与验证

检查音效是否加载

bash 复制代码

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

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

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

1. 拿到音效demo

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

c 复制代码

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

2. 匹配qcom ADSP架构模板

参考qcom算法移植文档：

audioreach_spf_common_audio_interface_capi...

smartpa/codec/AMP -- 功放芯片

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