Android-Audio-代码路径说明

Android Audio 代码路径详解

整体架构图

┌─────────────────────────────────────────────────────────────┐
│                   应用层 (Applications)                      │
├─────────────────────────────────────────────────────────────┤
│  Java Media Framework (android.media.*)                    │
├─────────────────────────────────────────────────────────────┤
│  JNI 桥接层 (android_media_*)                             │
├─────────────────────────────────────────────────────────────┤
│  C++ Media Framework (libmedia, libaudioclient)           │
├─────────────────────────────────────────────────────────────┤
│  音频服务层 (AudioFlinger, AudioPolicyService)            │
├─────────────────────────────────────────────────────────────┤
│  Audio HAL (Hardware Abstraction Layer)                   │
├─────────────────────────────────────────────────────────────┤
│  Linux 内核 (ALSA, tinyalsa, sound driver)                │
└─────────────────────────────────────────────────────────────┘

详细代码路径说明

1. Java Framework 层 (应用API)

路径: frameworks/base/media/java/android/media/

示例调用:

// 应用层代码
AudioTrack track = new AudioTrack.Builder()
    .setAudioAttributes(new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .build())
    .setAudioFormat(new AudioFormat.Builder()
        .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
        .setSampleRate(44100)
        .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO)
        .build())
    .build();
track.play();

2. JNI 桥接层

路径: frameworks/base/core/jni/

关键代码流:

Java AudioTrack.write() 
    → android_media_AudioTrack.cpp 的 write() 
    → C++ AudioTrack::write()

3. Native Client 层 (C++ API)

路径: frameworks/av/media/libaudioclient/

特点:

• 提供C++接口给Native应用
• 通过Binder与AudioFlinger通信
• 实现音频数据缓冲和传输

4. 核心服务层 (AudioFlinger)

路径: frameworks/av/services/audioflinger/

audioflinger/
├── AudioFlinger.h/cpp          # 主服务入口，管理所有音频线程
├── Threads.h/cpp               # 音频线程基类和派生类
│   ├── PlaybackThread         # 播放线程基类
│   ├── MixerThread           # 混音播放线程
│   ├── DirectOutputThread    # 直接输出线程
│   ├── OffloadThread         # 硬件解码线程
│   ├── DuplicatingThread     # 复制线程（录音/A2DP）
│   └── RecordThread          # 录制线程
├── Tracks.h/cpp               # 音频轨道管理
├── AudioMixer.h/cpp           # 混音器实现
├── Effects.h/cpp              # 音频效果框架
├── StateQueue.h/cpp           # 状态队列
├── FastCapture.h/cpp          # 快速录制
├── FastMixer.h/cpp            # 快速混音
└── AudioHwDevice.h/cpp       # 音频硬件设备封装

线程类型对比:

5. 策略服务层 (AudioPolicyService)

路径: frameworks/av/services/audiopolicy/

audiopolicy/
├── AudioPolicyService.h/cpp    # 策略服务入口
├── managerdefault/            # 默认策略实现
│   ├── AudioPolicyManager.h/cpp
│   └── AudioPolicyManagerDefault.cpp
├── engine/                    # 策略引擎
│   ├── Interface/            # 引擎接口
│   ├── common/               # 公共组件
│   ├── config/               # 配置管理
│   └── default/              # 默认引擎
├── common/                    # 公共工具
├── service/                   # 服务管理
└── Engine.h/cpp               # 策略引擎基类

主要功能:

• 设备选择策略
• 音量曲线管理
• 音频焦点管理
• 策略配置文件解析
• 动态策略切换

6. Audio HAL 接口定义

路径: hardware/libhardware/include/hardware/

关键结构体:

// 音频HAL主要接口
struct audio_hw_device {
    struct hw_device_t common;
    
    // 必须实现的函数
    int (*open_output_stream)(...);
    int (*close_output_stream)(...);
    int (*open_input_stream)(...);
    int (*close_input_stream)(...);
    
    // 音频控制函数
    int (*set_parameters)(...);
    char* (*get_parameters)(...);
    
    // 更多功能...
};

7. 厂商HAL实现路径

路径示例:

# Qualcomm平台
hardware/qcom/audio/
├── hal/                    # HAL实现
├── legacy/                # 旧版HAL
└── post_proc/             # 后处理

# 设备特定
device/<vendor>/<device>/audio/
├── hal/                   # 设备特定HAL
└── configs/              # 音频配置文件

8. 系统定义和配置文件

路径: system/media/audio/include/system/

路径: system/media/audio_utils/include/

9. 音频效果框架

路径: frameworks/av/media/libeffects/

libeffects/
├── factory/               # 效果工厂
│   └── EffectsFactory.c
├── lvm/                  # Loudness Maximizer
│   ├── lib/              # 库文件
│   └── bundle/           # 效果包
├── preprocessing/        # 预处理效果
│   ├── Include/         # 头文件
│   └── src/             # 源码
└── libs/                 # 效果库
    └── reverb/          # 混响效果

10. 音频工具和测试

路径: frameworks/av/media/libaudioclient/tests/

路径: frameworks/av/media/mtp/

关键配置文件路径

1. 音频策略配置

# 通用配置
/system/etc/audio_policy_configuration.xml
/system/etc/audio_policy_volumes.xml
/system/etc/audio_policy_volumes_drc.xml

# 设备特定配置
/vendor/etc/audio_policy_configuration.xml
/vendor/etc/audio_effects.xml

2. 效果配置文件

/system/etc/audio_effects.conf
/vendor/etc/audio_effects.conf
/data/misc/audio_effects/  # 用户效果配置

编译系统配置

路径: frameworks/av/services/audioflinger/Android.bp

cc_library_shared {
    name: "libaudioflinger",
    srcs: [
        "AudioFlinger.cpp",
        "Threads.cpp",
        "Tracks.cpp",
        // ...
    ],
    shared_libs: [
        "libaudioclient",
        "libmedia",
        "libcutils",
        // ...
    ],
    // ...
}

调试和日志

1. 日志标签

# 常用日志过滤
adb logcat -s AudioFlinger
adb logcat -s AudioPolicyManager
adb logcat -s AudioTrack
adb logcat -s AudioRecord
adb logcat -s audio_hw_primary
adb logcat -s audio_policy

2. 调试工具

# 音频调试工具
tinymix          # 混音器控制
tinyplay         # 音频播放
tinycap          # 音频录制
alsa_amixer      # ALSA混音器
alsa_aplay       # ALSA播放
alsa_arecord     # ALSA录制

# 系统工具
dumpsys media.audio_flinger  # AudioFlinger状态
dumpsys media.audio_policy   # AudioPolicy状态
dumpsys audio                # 音频系统状态

代码流程示例

音频播放完整流程：

1. App → AudioTrack.java (Java)
2. AudioTrack.write() → android_media_AudioTrack.cpp (JNI)
3. android_media_AudioTrack_write() → AudioTrack.cpp (C++)
4. AudioTrack::obtainBuffer() → AudioTrack::write() (libaudioclient)
5. AudioTrack::createTrackI() → IAudioFlinger.createTrack() (Binder IPC)
6. AudioFlinger.createTrack() (services/audioflinger)
7. AudioFlinger::PlaybackThread::createTrack_l()
8. AudioFlinger::MixerThread::prepareTracks_l()
9. AudioFlinger::AudioMixer::process()
10. PlaybackThread::threadLoop_write()
11. AudioStreamOut::write() (HAL)
12. audio_hw_device::out_write() (厂商HAL)
13. tinyalsa/ALSA驱动写入

常见问题定位路径

这个代码路径结构反映了Android音频系统的模块化设计，每个层级都有明确的职责边界，便于维护和扩展。