简介： CSDN博客专家、《Android系统多媒体进阶实战》作者

博主新书推荐：《Android系统多媒体进阶实战》🚀
Android Audio工程师专栏地址： Audio工程师进阶系列【原创干货持续更新中……】🚀
Android多媒体专栏地址： 多媒体系统工程师系列【原创干货持续更新中……】🚀
专题一 二：AAOS车载系统+AOSP14系统攻城狮入门视频实战课 🚀
专题三：Android14 Binder之HIDL与AIDL通信实战课 🚀
专题四：Android15快速自定义与集成音效实战课 🚀
专题五：Android15音频策略实战课 🚀
专题六：Android15音频性能实战课(无声/杂音/断音/爆音实战案例) 🚀

人生格言： 人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.

🌻1. 前言

本篇目的：Android16音频深度解析之 LoudnessEnhancer.setTargetGain 调用流程与实战。

在 Android 音频处理框架中，针对音源过小导致的听感不佳，LoudnessEnhancer（响度增强器）提供了一种非破坏性的增益方案。其要点如下：

• 毫贝单位控制：该方法使用毫贝（mB）作为单位设置目标增益（$100\text{ mB}=1\text{ dB}$），支持精细的音量补偿。
• 安全增益补偿：主要用于提升原本录制电平较低的音轨，使其在不产生严重削波失真的前提下达到理想的听觉响度。
• 实时动态调节：允许在媒体播放过程中动态调整增益值，广泛应用于视频会议和弱音媒体播放场景。
• 落地建议：设置增益时应循序渐进，避免瞬间极高增益对扬声器硬件或用户听力造成冲击。

🌻2. 用法与应用场景

LoudnessEnhancer.setTargetGain(int gainmB) 用于设定响度增强器的目标增益值。

• 用法说明：参数 gainmB 为目标增益，单位为毫贝。例如，若需增益 3 dB，则传入 300。
• 运行结果：音频输出链路的整体电平被抬升，用户会感知到明显的音量放大效果。
• 应用场景：
  1. 低电平媒体修复：对于一些老旧电影或录音电平极低的音频文件进行实时响度补偿。
  2. 嘈杂环境播放：在户外等高噪音环境下，通过逻辑算法进一步榨取硬件的输出潜力。
  3. 无障碍辅助：为听障人士提供超越系统默认最大音量的特定频率或全频段增强。

🌻3. 调用流程剖析

3.1 核心步骤

1. Java 层参数校验：应用调用 setTargetGain。LoudnessEnhancer.java 检查参数是否在系统允许的范围内，随后通过 JNI 接口下发。
2. JNI 命令封装：指令进入 android_media_AudioEffect.cpp。系统将参数封装为 LOUDNESS_ENHANCER_PARAM_TARGET_GAIN 类型的命令块。
3. AudioFlinger 路由：通过 Binder 机制，请求发送至 MediaServer 进程。AudioFlinger 根据会话 ID（Session ID）定位到具体的 EffectHandle。
4. 引擎增益更新：底层的响度增强引擎（通常位于 libloudnessenhancer）接收到新参数，更新其内部的乘法因子（Gain Factor）。
5. PCM 数据加权：音频处理线程在下一个混音周期内，将新的增益值作用于每一帧 PCM 采样数据，实现物理意义上的音量放大。

3.2 涉及核心时序图

🌻4. 实战应用案例

public class AudioBoostManager {
    private LoudnessEnhancer loudnessEnhancer;

    public void boostVolume(int sessionId, int gainDb) {
        try {
            // 1. 初始化响度增强器
            loudnessEnhancer = new LoudnessEnhancer(sessionId);
            
            // 2. 将 dB 转换为 mB (1dB = 100mB)
            int targetGainmB = gainDb * 100;

            // 3. 设置目标增益值
            loudnessEnhancer.setTargetGain(targetGainmB);
            
            // 4. 使能效果器
            loudnessEnhancer.setEnabled(true);
            
            System.out.println("响度增强已激活，目标增益: " + gainDb + " dB");
        } catch (Exception e) {
            System.err.println("初始化响度增强器失败: " + e.getMessage());
        }
    }

    public void updateGain(int extraDb) {
        if (loudnessEnhancer != null && loudnessEnhancer.getEnabled()) {
            // 动态调整增益
            loudnessEnhancer.setTargetGain(extraDb * 100);
        }
    }

    public void release() {
        if (loudnessEnhancer != null) {
            loudnessEnhancer.setEnabled(false);
            loudnessEnhancer.release();
            loudnessEnhancer = null;
        }
    }
}

🌻5. 用法总结

最优实战方案落地步骤：

1. Session 绑定：务必获取当前 MediaPlayer 或 AudioTrack 的 AudioSessionId 进行精确绑定，而非使用全局 Session。
2. 阶梯递增：在 UI 调节逻辑中，建议以 100 mB（1 dB）为步长，防止跨度过大导致爆音。
3. 状态先行：建议在调用 setEnabled(true) 前先调用 setTargetGain，保证效果器开启即为目标响度。
4. 资源回收：由于响度增强涉及底层 DSP 运算，在 Activity 销毁或播放停止时必须显式调用 release()。