为android系统添加USB AUDIO设备的放音和录音功能

转自:http://blog.csdn.net/adits/article/details/8242146


开发环境简介

1. 主机系统: Unbuntu10.10
2. android系统版本: 4.0.3(Linux kernel 3.0.8)

综述


android的音频系统非常庞大复杂:涉及到java应用程序,java框架层,JNI,本地服务(AudioFlinger和AudioPolicyService),硬件抽象层HAL,ALSA-LIB和ALSA-DRIVER。

本文将先分析音频系统的启动与模块加载流程,并具体分析一个JAVA API的调用流程;最后在此基础上自然地为android系统添加USB AUDIO设备的放音和录音功能。


全文可分为如下几大部分:


1. 本地服务的启动流程分析。
1.1 AudioFlinger启动流程及其所涉及的HAL层模块启动流程分析。
1.2 AudioPolicyService启动流程及其所涉及的HAL层模块启动流程分析。
2. JAVA API setDeviceConnectionState()调用流程详解,同时为android系统添加USB AUDIO设备的放音和录音功能。
3. ALSA-LIB浅述以及asound.conf配置文件的书写。

4. 重新获取USB AUDIO设备的硬件参数。


1. 本地服务的启动流程分析。

AudioFlinger和AudioPolicyService两大音频服务都是在android系统启动时就启动的。

当linux kenerl启动完成后,会启动android的init进程(system/core/init/init.c)。

[cpp]  view plain copy print ?
  1. int main(int argc, char **argv)  
  2. {  
  3.     .....  

  4.     init_parse_config_file("/init.rc");  

  5.     .....  
  6. }

init.rc文件中保存了许多系统启动时需要启动的服务。其中就有多媒体服务mediaserver的启动:

[plain]  view plain copy print ?
  1. service media /system/bin/mediaserver

此服务在文件frameworks/base/media/mediaserver/main_mediaserver.cpp中定义,

而音频子系统的两大本地服务AudioFlinger和AudioPolicyService就是在此启动的。

[cpp]  view plain copy print ?
  1. int main(int argc, char** argv)  
  2. {  
  3.    .....  
  4.   
  5.     AudioFlinger::instantiate();  //实例化AudioFlinger
  6.     .....  
  7.   
  8.     AudioPolicyService::instantiate(); //实例化AudioPolicyService
  9.       
  10.     .....  
  11. }


1.1 AudioFlinger启动流程及其所涉及的HAL层模块启动流程分析。

根据上文分析,将调用AudioFlinger::instantiate()函数实例化AudioFlinger。

但是AudioFlinger.cpp中并没有找到此函数,那必然在其父类中。AudioFlinger类有很多父类,一时难以确定instantiate()到底在哪个父类中定义的。直接搜索吧!
grep -rn "instantiate"  frameworks/base/ 
很快找到instantiate()函数的定义处在./frameworks/base/include/binder/BinderService.h头文件中

[cpp]  view plain copy print ?
  1. template<typename SERVICE>  
  2. class BinderService  
  3. {  
  4. public:  
  5.     static status_t publish() {  
  6.         sp sm(defaultServiceManager());  
  7.         return sm->addService(String16(SERVICE::getServiceName()), new SERVICE());  
  8.   
  9.     ......  
  10.   
  11.     static void instantiate() { publish(); }  
  12.   
  13.     .....  
  14.     }    
  15. }

这里用到了模板,需要确定SERVICE是什么东东。
AudioFlinger类是在AudioFlinger.h中定义的,而恰好包含了头文件BinderService.h。

[cpp]  view plain copy print ?
  1. class AudioFlinger :  
  2.     public BinderService,  
  3.     public BnAudioFlinger  
  4. {  
  5.     friend class BinderService;  
  6. public:  
  7.     static char const* getServiceName() { return "media.audio_flinger"; }  
  8.   
  9.     .....  
  10.   
  11. }

原来AudioFlinger类继承了BinderService类,同时把自己(AudioFlinger)传递给SERVICE。

而addService函数第一个参数调用了AudioFlinger类的静态成员函数getServiceName()获取AudioFlinger的服务名称;

其第二个参数便是创建了一个AudioFlinger的实例。至此,明白了实例化函数instantiate()就是要向服务管理器注册的服务是AudioFlinger。
既然此时实例化了AudioFlinger,那么看看AudioFlinger类的构造函数具体做了哪些初始化工作。

[cpp]  view plain copy print ?
  1. AudioFlinger::AudioFlinger()  
  2.     : BnAudioFlinger(),  
  3.         mPrimaryHardwareDev(0), mMasterVolume(1.0f), mMasterMute(false), mNextUniqueId(1),  
  4.         mBtNrecIsOff(false)  
  5. {  
  6. }

此构造函数做了一些无关紧要的事情,不管它。既然AudioFlinger服务是第一次启动,则将调到函数AudioFlinger::onFirstRef(至于为什么,我还没有搞明白,可以通过log信息确信确实是这么回事)。

void AudioFlinger::onFirstRef()

{
    ......
    for (size_t i = 0; i < ARRAY_SIZE(audio_interfaces); i++) {
        const hw_module_t *mod;
        audio_hw_device_t *dev;
        rc = load_audio_interface(audio_interfaces[i], &mod,&dev);
        .....
        mAudioHwDevs.push(dev); // 把通过load_audio_interface()函数获得的设备存入元素为audio_hw_device_t
    .....                                                 // 类型的模板变量mAudioHwDevs中
}

看到load_audio_interface()函数的名字,知晓,应当是加载音频接口的。

[cpp]  view plain copy print ?
  1. static int load_audio_interface(const char *if_name, const hw_module_t **mod,  
  2.                                 audio_hw_device_t **dev)  
  3. {         
  4.     ......  
  5.   
  6.     rc = hw_get_module_by_class(AUDIO_HARDWARE_MODULE_ID, if_name, mod);  
  7.     if (rc)  
  8.         goto out;  
  9.           
  10.     rc = audio_hw_device_open(*mod, dev);  
  11.   
  12.     .....  
  13.   
  14. }

首先通过函数hw_get_module_by_class获取ID号为AUDIO_HARDWARE_MODULE_ID的音频模块,此ID在头文件hardware/libhardware/include/hardware/audio.h中定义。

此头文件中定义了一个十分重要的结构体struct audio_hw_device,其中包含了许多函数接口(函数指针):

[cpp]  view plain copy print ?
  1. struct audio_hw_device {  
  2.     struct hw_device_t common;  
  3.   
  4.     /**  
  5.      * used by audio flinger to enumerate what devices are supported by 
  6.      * each audio_hw_device implementation. 
  7.      * 
  8.      * Return value is a bitmask of 1 or more values of audio_devices_t 
  9.      */  
  10.     uint32_t (*get_supported_devices)(const struct audio_hw_device *dev);  
  11.   
  12.     /**  
  13.      * check to see if the audio hardware interface has been initialized. 
  14.      * returns 0 on success, -ENODEV on failure. 
  15.      */  
  16.     int (*init_check)(const struct audio_hw_device *dev);  
  17.   
  18.    ......  
  19.   
  20.     /* set/get global audio parameters */  
  21.     int (*set_parameters)(struct audio_hw_device *dev, const char *kv_pairs);  
  22.   
  23.    .....  
  24.   
  25.     /** This method creates and opens the audio hardware output stream */  
  26.     int (*>open_output_stream)(struct audio_hw_device *dev, uint32_t devices,  
  27.                               int *format, uint32_t *channels,  
  28.                               uint32_t *sample_rate,  
  29.                               struct audio_stream_out **out);  
  30.   
  31.    ......  
  32.   
  33.     /** This method creates and opens the audio hardware input stream */  
  34.     int (*open_input_stream)(struct audio_hw_device *dev, uint32_t devices,  
  35.                              int *format, uint32_t *channels,  
  36.                              uint32_t *sample_rate,  
  37.                              audio_in_acoustics_t acoustics,  
  38.                              struct audio_stream_in **stream_in);  
  39.   
  40.    .....  
  41. }

ID为AUDIO_HARDWARE_MODULE_ID的音频模块到底在哪儿定义的那?既然是HAL层模块,必定在hardware目录下定义的

[plain]  view plain copy print ?
  1. $ grep -rn AUDIO_HARDWARE_MODULE_ID hardware/  
  2. hardware/libhardware_legacy/audio/audio_hw_hal.cpp:602:id: AUDIO_HARDWARE_MODULE_ID,  
  3. hardware/libhardware/modules/audio/audio_hw.c:435:   .id = AUDIO_HARDWARE_MODULE_ID,  
  4. hardware/libhardware/include/hardware/audio.h:37:  
  5.                                             #define AUDIO_HARDWARE_MODULE_ID "audio"
从搜索结果发现,AUDIO_HARDWARE_MODULE_ID的音频模块有两处定义,具体用的是哪一个那?
先分析下这两个模块最终编译进哪些模块。
通过查阅Android.mk晓得,audio_hw.c先被编译进audio_policy.stub模块,而后被编译进libhardware模块;
同样的,audio_hw_hal.cpp先被编译进libaudiopolicy_legacy模块,而后被编译进libhardware_legacy模块;
而libhardware和libhardware_legacy模块都在audioFlinger中用到。
通过log信息,确认使用的是libaudiopolicy_legacy模块,即具体调到hardware/libhardware_legacy/audio/audio_hw_hal.cpp文件中所定义的模块了。

在获取到HAL层音频模块后,接下来执行audio_hw_device_open()函数,打开设备。此函数也在audio.h头文件中定义,函数体如下:

[cpp]  view plain copy print ?
  1. /** convenience API for opening and closing a supported device */  
  2.   
  3. static inline int audio_hw_device_open(const struct hw_module_t* module,  
  4.                                        struct audio_hw_device** device)  
  5. {  
  6.     return module->methods->open(module, AUDIO_HARDWARE_INTERFACE,  
  7.                                  (struct hw_device_t**)device);  
  8. }

struct hw_module_t是在hardware/libhardware/include/hardware/hardware.h头文件中定义的,其中嵌套了struct hw_module_methods_t。此结构体很简单,只有一个函数指针open

[cpp]  view plain copy print ?
  1. typedef struct hw_module_methods_t {  
  2.     /** Open a specific device */  
  3.     int (*open)(const struct hw_module_t* module, const char* id,   
  4.             struct hw_device_t** device);  
  5.   
  6. } hw_module_methods_t;

在确定具体模块后,很容易确定open函数指针的具体实现

[cpp]  view plain copy print ?
  1. struct legacy_audio_module HAL_MODULE_INFO_SYM = {   
  2.     module: {  
  3.         common: {  
  4.             tag: HARDWARE_MODULE_TAG,  
  5.             version_major: 1,  
  6.             version_minor: 0,  
  7.             id: AUDIO_HARDWARE_MODULE_ID,  
  8.             name: "LEGACY Audio HW HAL",  
  9.             author: "The Android Open Source Project",  
  10.             methods: &legacy_audio_module_methods,  
  11.             dso : NULL,  
  12.             reserved : {0},  
  13.         },    
  14.     },    
  15. };

[cpp]  view plain copy print ?
  1. static struct hw_module_methods_t legacy_audio_module_methods = {   
  2.         open: legacy_adev_open
  3. };
open()的实现就是legacy_adev_open()函数了!

[cpp]  view plain copy print ?
  1. static int legacy_adev_open(const hw_module_t* module, const char* name,  
  2.                             hw_device_t** device)  
  3. {  
  4.     struct legacy_audio_device *ladev;  
  5.     int ret;  
  6.   
  7.     if (strcmp(name, AUDIO_HARDWARE_INTERFACE) != 0)  // 看来对应宏AUDIO_HARDWARE_INTERFACE,除了用来判断希望打开的是否音频硬件接口外,并没有做什么更多的事情  
  8.         return -EINVAL;  
  9.   
  10.     .....  
  11.   
  12.     ladev->device.get_supported_devices = adev_get_supported_devices;  
  13.     ladev->device.init_check = adev_init_check;  
  14.   
  15.     .....  
  16.   
  17.     ladev->device.open_output_stream = adev_open_output_stream;  
  18.     ladev->device.close_output_stream = adev_close_output_stream;  
  19.     ladev->device.open_input_stream = adev_open_input_stream;  
  20.     ladev->device.close_input_stream = adev_close_input_stream;  
  21.   
  22.     .....  
  23.   
  24.     ladev->hwif = createAudioHardware();  
  25.   
  26.     .....  
  27.     *device = &ladev->device.common;  // 将当前设备信息层层返回给回调函数,最后返回到  
  28.                                       // load_audio_interface()函数,并保存在  
  29.                                       // mAudioHwDevs模板变量中,供AudioFlinger类使用。  
  30.     return 0;   
  31. }

这里主要做了一些初始化工作,即给函数指针提供具体实现函数;但createAudioHardware()应该做了更多的事情。
先从函数createAudioHardware()的返回值入手。struct legacy_audio_device的定义如下:

[cpp]  view plain copy print ?
  1. struct legacy_audio_device {  
  2.     struct audio_hw_device device;  
  3.           
  4.     struct AudioHardwareInterface *hwif;  
  5. }; 

原来createAudioHardware()的返回值是一个硬件设备接口AudioHardwareInterface。
类AudioHardwareInterface正好在audio_hw_hal.cpp文件中所包含的头文件hardware_legacy/AudioHardwareInterface.h中定义的虚类(结构体能调到类,还是头一遭见到,

虽然结构体和类长得很象)。那么我很想知道createAudioHardware()具体做了哪些事情。
首先需要确定函数createAudioHardware()的定义在哪儿?有几处定义?调用的具体是哪一个?
AudioHardwareInterface.h头文件中对createAudioHardware函数的声明,没有包含在任何类中,

而仅仅包含在名字空间android_audio_legacy中,这和audio_hw_hal.cpp同在一个名字空间中。

[cpp]  view plain copy print ?
  1. namespace android_audio_legacy {  
  2.   
  3.     .....  
  4.   
  5. extern "C" AudioHardwareInterface* createAudioHardware(void);  
  6. }; // namespace android

经搜索,发现createAudioHardware()函数有四处定义。

[cpp]  view plain copy print ?
  1. $ grep -rn createAudioHardware hardware/ --exclude-dir=.svn  
  2. hardware/alsa_sound/AudioHardwareALSA.cpp:45:      
  3.           android_audio_legacy::AudioHardwareInterface *createAudioHardware(void) {  
  4. hardware/msm7k/libaudio-qsd8k/AudioHardware.cpp:2021:  
  5.                      extern "C" AudioHardwareInterface* createAudioHardware(void) {  
  6. hardware/msm7k/libaudio-qdsp5v2/AudioHardware.cpp:337:  
  7.                      extern "C" AudioHardwareInterface* createAudioHardware(void) {  
  8. hardware/msm7k/libaudio/AudioHardware.cpp:1132:  
  9.                      extern "C" AudioHardwareInterface* createAudioHardware(void) { 

只有AudioHardwareALSA.cpp文件中包含了头文件hardware_legacy/AudioHardwareInterface.h,并且返回值是android_audio_legacy名字空间的AudioHardwareInterface类对象。

则createAudioHardware函数的具体实现很可能是它了,通过log信息证明了这一点。


进入AudioHardwareALSA.cpp,不难看出,此函数,最后会通过执行代码如下代码创建AudioHardwareALSA类对象。

[cpp]  view plain copy print ?
  1. return new AudioHardwareALSA();

AudioHardwareALSA类的构造函数如下:

[cpp]  view plain copy print ?
  1. AudioHardwareALSA::AudioHardwareALSA() :  
  2.     mALSADevice(0),  
  3.     mAcousticDevice(0)  
  4. {   
  5.     ......  
  6.   
  7.     int err = hw_get_module(ALSA_HARDWARE_MODULE_ID,  
  8.             (hw_module_t const**)&module);  
  9.   
  10.     if (err == 0) {  
  11.         hw_device_t* device;  
  12.         err = module->methods->open(module, ALSA_HARDWARE_NAME, &device);  
  13.         if (err == 0) {  
  14.             mALSADevice = (alsa_device_t *)device;  
  15.             mALSADevice->init(mALSADevice, mDeviceList);  
  16.   
  17.     .....  
  18.   
  19.     err = hw_get_module(ACOUSTICS_HARDWARE_MODULE_ID,  
  20.             (hw_module_t const**)&module);                                                                                           
  21.   
  22.     if (err == 0) {  
  23.         hw_device_t* device;  
  24.         err = module->methods->open(module, ACOUSTICS_HARDWARE_NAME, &device);   
  25.   
  26.     .....  
  27. }

宏ALSA_HARDWARE_MODULE_ID是在头文件hardware/alsa_sound/AudioHardwareALSA.h中定义的。
模块所对应的结构体类型为hw_module_t,在头文件hardware/libhardware/include/hardware/hardware.h中定义。
在构造函数中,首先调用函数hw_get_module()获取ID为ALSA_HARDWARE_MODULE_ID的ALSA硬件模块,看来即将进入庞大而又功能强大的ALSA音频子系统了!

经过搜索,很快确定ID为ALSA_HARDWARE_MODULE_ID的ALSA硬件抽象层的具体实现在文件hardware/alsa_sound/alsa_default.cpp中。

[cpp]  view plain copy print ?
  1. $ grep -rn ALSA_HARDWARE_MODULE_ID hardware/ --exclude-dir=.svn  
  2. hardware/alsa_sound/AudioHardwareALSA.h:39:#define ALSA_HARDWARE_MODULE_ID "alsa"  
  3. hardware/alsa_sound/alsa_default.cpp:59:      
  4.                                         id              : ALSA_HARDWARE_MODULE_ID,  
  5. hardware/alsa_sound/AudioHardwareALSA.cpp:150:      
  6.                                    int err = hw_get_module(ALSA_HARDWARE_MODULE_ID,

则很快找到此模块的具体内容如下:

[cpp]  view plain copy print ?
  1. extern "C" const hw_module_t HAL_MODULE_INFO_SYM = {   
  2.     tag             : HARDWARE_MODULE_TAG,  
  3.     version_major   : 1,  
  4.     version_minor   : 0,  
  5.     id              : ALSA_HARDWARE_MODULE_ID,  
  6.     name            : "ALSA module",  
  7.     author          : "Wind River",  
  8.     methods         : &s_module_methods,  
  9.     dso             : 0,  
  10.     reserved        : { 0, },  
  11. };

s_module_methods函数的实现如下:

[cpp]  view plain copy print ?
  1. static hw_module_methods_t s_module_methods = {   
  2.     open            : s_device_open  
  3. };

s_device_open函数的实现如下:

[cpp]  view plain copy print ?
  1. static int s_device_open(const hw_module_t* module, const char* name,  //有些困惑,  
  2.               // 此open函数实现中并没有对调用者传递下来的name(ALSA_HARDWARE_NAME)作如何处理。
  3.         hw_device_t** device) //device存储返回的模块信息
  4. {  
  5.     alsa_device_t *dev;  
  6.     dev = (alsa_device_t *) malloc(sizeof(*dev));  
  7.     if (!dev) return -ENOMEM;  
  8.   
  9.     memset(dev, 0, sizeof(*dev));  
  10.   
  11.     /* initialize the procs */  
  12.     dev->common.tag = HARDWARE_DEVICE_TAG;  
  13.     dev->common.version = 0;  
  14.     dev->common.module = (hw_module_t *) module;  
  15.     dev->common.close = s_device_close;  
  16.     dev->init = s_init;  
  17.     dev->open = s_open;  
  18.     dev->close = s_close;  
  19.     dev->route = s_route;  
  20.   
  21.     *device = &dev->common; // 把此模块信息返回给调用者  
  22.     return 0;  

经过上述分析,知道了module->methods->open函数具体调用流程了。

然后对ALSA硬件抽象层模块做了初始化的工作。
这里用到一个结构体变量mALSADevice,它在头文件hardware/alsa_sound/AudioHardwareALSA.h中定义的struct alsa_device_t变量。

[cpp]  view plain copy print ?
  1. struct alsa_device_t {  
  2.     hw_device_t common;  
  3.       
  4.     status_t (*init)(alsa_device_t *, ALSAHandleList &);  
  5.     status_t (*open)(alsa_handle_t *, uint32_t, int);  
  6.     status_t (*close)(alsa_handle_t *);  
  7.     status_t (*route)(alsa_handle_t *, uint32_t, int);  
  8. }; 

此结构体仅仅提供了一些函数调用接口,在这里都有了具体的实现。则mALSADevice->init()将调到s_init()函数中。

[cpp]  view plain copy print ?
  1. static status_t s_init(alsa_device_t *module, ALSAHandleList &list)  
  2. {  
  3.     list.clear();  
  4.   
  5.     snd_pcm_uframes_t bufferSize = _defaultsOut.bufferSize;  
  6.   
  7.     for (size_t i = 1; (bufferSize & ~i) != 0; i <<= 1)  
  8.         bufferSize &= ~i;       
  9.   
  10.     _defaultsOut.module = module;    
  11.     _defaultsOut.bufferSize = bufferSize;  
  12.   
  13.     list.push_back(_defaultsOut);
  14.   
  15.     bufferSize = _defaultsIn.bufferSize;  
  16.   
  17.     .....  
  18.   
  19.     list.push_back(_defaultsIn);
  20.   
  21.     .....  
  22. }

这里会把_defaultsOut和_defaultsIn东东保存在ALSA句柄列表ALSAHandleList中。
首先需要明确_defaultsOut和_defaultsIn具体是什么东东。

[cpp]  view plain copy print ?
  1. static alsa_handle_t _defaultsOut = {  
  2.     module      : 0,  
  3.     devices     : android_audio_legacy::AudioSystem::DEVICE_OUT_ALL,  // 支持的所有  
  4.                                                                       // 输出音频设备  
  5.     curDev      : 0,  
  6.     curMode     : 0,  
  7.     handle      : 0,  // PCM节点  
  8.     format      : SND_PCM_FORMAT_S16_LE, // AudioSystem::PCM_16_BIT   
  9.     channels    : 2,    
  10.     sampleRate  : DEFAULT_SAMPLE_RATE,    
  11.     latency     : 200000, // Desired Delay in usec  
  12.     bufferSize  : DEFAULT_SAMPLE_RATE / 5, // Desired Number of samples  
  13.     modPrivate  : 0,  
  14. };  
  15.   
  16. static alsa_handle_t _defaultsIn = {  
  17.     module      : 0,  
  18.     devices     : android_audio_legacy::AudioSystem::DEVICE_IN_ALL, // 支持的所有  
  19.                                                                     // 输入音频设备
  20.     curDev      : 0,  
  21.     curMode     : 0,  
  22.     handle      : 0, // PCM节点  
  23.     format      : SND_PCM_FORMAT_S16_LE, // AudioSystem::PCM_16_BIT  
  24.     channels    : 2, // 声道数: 1表示单声道,2表示立体声。如果与实际使用的USB AUDIO设备参数  
  25.                      // 的不一致,将导致USB AUDIO设备不能使用。
  26.     sampleRate  : DEFAULT_SAMPLE_RATE, // 采样率,如果与实际使用的USB AUDIO设备参数  
  27.                                        // 的不一致,将导致声音失真  
  28.     latency     : 250000, // Desired Delay in usec
  29.     bufferSize  : 2048, // Desired Number of samples  
  30.     modPrivate  : 0,  
  31. };

那ALSAHandleList又是什么东东?
ALSAHandleList在头文件hardware/alsa_sound/AudioHardwareALSA.h中定义的List模板变量。
typedef List ALSAHandleList;
原来就是struct asla_handle_t的一个列表而已,而_defaultsOut和_defaultsIn正是这样的结构体变量。

[cpp]  view plain copy print ?
  1. struct alsa_handle_t {  
  2.     alsa_device_t *     module;  
  3.     uint32_t            devices;  
  4.     uint32_t            curDev;  
  5.     int                 curMode;  
  6.     snd_pcm_t *         handle;  // PCM节点  
  7.     snd_pcm_format_t    format;  
  8.     uint32_t            channels;  
  9.     uint32_t            sampleRate;
  10.     unsigned int        latency;         // Delay in usec  
  11.     unsigned int        bufferSize;      // Size of sample buffer  
  12.     void *              modPrivate;  
  13. };

ALSA硬件抽象层正是这样获得了输出音频通道和输入音频通道的相关初始化硬件参数,以后在使用中并不试图改变这些硬件参数(针对真能手机和平板来说,也却是不需要改变)。

因此,在扩展android系统功能,为其添加对USB AUDIO设备的支持时,就不得不考虑时事改变channels和sampleRate这两个硬件参数的值。

至此,AudioFlinger服务首次启动过程分析完毕!

1.2 AudioPolicyService启动流程及其所涉及的HAL层模块启动流程分析。


AudioPolicyService服务的启动流程类似于AudioFlinger服务的启动过程,将简要分析。
先看下AudioPolicyService类的定义(AudioPolicyService.h)(提供此类的定义,主要是为下面instantiate()函数服务的):

class AudioPolicyService :  
    public BinderService,  // 继承了BinderService类,  
                                              // 并把自己(AudioPolicyService)传递给  
                                              // BinderService。  
    public BnAudioPolicyService,  
//    public AudioPolicyClientInterface,  
    public IBinder::DeathRecipient  
{  
    friend class BinderService;  
  
public:  
    // for BinderService  
    static const char *getServiceName() { return "media.audio_policy"; }  
  
    .....  
}
根据前面的分析,晓得将通过调用如下代码启动AudioPolicyService服务。

AudioPolicyService::instantiate();
此代码最后将调到AudioPolicyService类的构造函数

AudioPolicyService::AudioPolicyService()  
    : BnAudioPolicyService() , mpAudioPolicyDev(NULL) , mpAudioPolicy(NULL)  
{  
    char value[PROPERTY_VALUE_MAX];  
    const struct hw_module_t *module;  
    int forced_val;  
    int rc;  
  
    Mutex::Autolock _l(mLock);  
  
    // start tone playback thread  
    mTonePlaybackThread = new AudioCommandThread(String8(""));  
    // start audio commands thread  
    mAudioCommandThread = new AudioCommandThread(String8("ApmCommandThread"));  
  
    /* instantiate the audio policy manager */  
    rc = hw_get_module(AUDIO_POLICY_HARDWARE_MODULE_ID, &module);  
    if (rc)  
        return;  
  
    rc = audio_policy_dev_open(module, &mpAudioPolicyDev);  
    LOGE_IF(rc, "couldn't open audio policy device (%s)", strerror(-rc));  
    if (rc)  
        return;  
  
    rc = mpAudioPolicyDev->create_audio_policy(mpAudioPolicyDev, &aps_ops, this,  
                                              &mpAudioPolicy);  
    LOGE_IF(rc, "couldn't create audio policy (%s)", strerror(-rc));  
    if (rc)  
        return;  
  
    rc = mpAudioPolicy->init_check(mpAudioPolicy);  
  
    .....  
  
}
(1)首先开启了放音线程和音频命令线程。这些工作都是通过创建AudioCommandThread线程类对象完成。

AudioCommandThread类在头文件frameworks/base/services/audioflinger/AudioPolicyService.h中定义,是AudioPolicyService类的私有子类。

AudioCommandThread线程类创建了对象后,将进入死循环中,等待要处理的事件传来。

bool AudioPolicyService::AudioCommandThread::threadLoop()  
{  
    nsecs_t waitTime = INT64_MAX;  
  
    mLock.lock();  
    while (!exitPending())  
    {  
        while(!mAudioCommands.isEmpty()) {  
           .....  
              
                switch (command->mCommand) {  
  
                .....  
  
                case SET_PARAMETERS: {  
                     ParametersData *data = (ParametersData *)command->mParam;  
                     LOGV("AudioCommandThread() processing set parameters string %s, io %d",  
                             data->mKeyValuePairs.string(), data->mIO);  
                     command->mStatus = AudioSystem::setParameters(data->mIO, data->mKeyValuePairs);  
                     if (command->mWaitStatus) {  
                         command->mCond.signal();  
                         mWaitWorkCV.wait(mLock);  
                     }  
                     delete data;  
                     }break;  
  
    .....  
}

这里只列出了switch语句中的一种情况的处理代码,因为后面分析setDeviceConnectionState()函数的调用流程时将用到。

当command->mCommand值为SET_PARAMETERS时,将调用libmedia库(frameworks/base/media/libmedia/AudioSystem.cpp)中的函数setParameters()做进一步处理。

(2)然后调用函数hw_get_module()获得ID号为AUDIO_POLICY_HARDWARE_MODULE_ID的硬件抽象层的音频策略模块。

宏AUDIO_POLICY_HARDWARE_MODULE_ID在头文件hardware/libhardware/include/hardware/audio_policy.h中定义。

ID号为AUDIO_POLICY_HARDWARE_MODULE_ID的模块也有两处具体实现,同样通过log信息,确认调用的是libhardware_legacy模块中的AUDIO_POLICY_HARDWARE_MODULE_ID子模块的具体实现。

[cpp]  view plain copy print ?
  1. $ grep -rn AUDIO_POLICY_HARDWARE_MODULE_ID hardware/ --exclude-dir=.svn  
  2. hardware/libhardware_legacy/audio/audio_policy_hal.cpp:414:  
  3.                                                 id: AUDIO_POLICY_HARDWARE_MODULE_ID,  
  4. hardware/libhardware/modules/audio/audio_policy.c:318:   
  5.                                   .id             = AUDIO_POLICY_HARDWARE_MODULE_ID,

audio_policy_hal.cpp文件中定义的AUDIO_POLICY_HARDWARE_MODULE_ID。


(3)再然后调用audio_policy_dev_open()函数(在头文件hardware/libhardware/include/hardware/audio_policy.h中定义)。

首先分析函数参数:第一个参数就是上面获取的模块,第二个参数mpAudioPolicyDev是struct audio_policy_device 指针变量,在头文件AudioPolicyService.h中定义。


而struct audio_policy_device是在头文件audio_policy.h中定义的。


由上述分析可知,open函数指针就指向legacy_ap_dev_open()函数。

static int legacy_ap_dev_open(const hw_module_t* module, const char* name,  
                                    hw_device_t** device) // 参数device保存返回的模块信息  
{  
    struct legacy_ap_device *dev;  
  
    if (strcmp(name, AUDIO_POLICY_INTERFACE) != 0)// 参数name(AUDIO_POLICY_INTERFACE)  
                                                  // 就这点用处  
        return -EINVAL;  
  
    dev = (struct legacy_ap_device *)calloc(1, sizeof(*dev));  
    if (!dev)  
        return -ENOMEM;  
  
    dev->device.common.tag = HARDWARE_DEVICE_TAG;  
    dev->device.common.version = 0;  
    dev->device.common.module = const_cast(module);  
    dev->device.common.close = legacy_ap_dev_close;  
    dev->device.create_audio_policy = create_legacy_ap;  
    dev->device.destroy_audio_policy = destroy_legacy_ap;  
  
    *device = &dev->device.common;// 将当前模块具体信息赋值给device,并回馈给调用者 
  
    return 0;  
}
(4)再接下来调用的mpAudioPolicyDev->create_audio_policy()函数指针具体就是create_legacy_ap()。

第二个参数&aps_ops是struct audio_policy_service_ops变量,是APS(AudioPolicyService)的操作接口,并且传递的是aps_ops的地址,则被调用者使用的将是在APS中函数接口的实现。

namespace {  
    struct audio_policy_service_ops aps_ops = {  
        open_output           : aps_open_output,
        open_duplicate_output : aps_open_dup_output,  
        close_output          : aps_close_output,  
        suspend_output        : aps_suspend_output,  
        restore_output        : aps_restore_output,  
        open_input            : aps_open_input,  
        close_input           : aps_close_input,  
        set_stream_volume     : aps_set_stream_volume,  
        set_stream_output     : aps_set_stream_output,  
        set_parameters        : aps_set_parameters,
        get_parameters        : aps_get_parameters,  
        start_tone            : aps_start_tone,  
        stop_tone             : aps_stop_tone,  
        set_voice_volume      : aps_set_voice_volume,  
        move_effects          : aps_move_effects,  
    };  
}; // namespace 

struct audio_policy_service_ops在头文件hardware/libhardware/include/hardware/audio_policy.h中定义,是包含音频相关控制函数的接口。可见aps_ops接口将为HAL层提供服务。

第四个参数是&mpAudioPolicy。mpAudioPolicy是struct audio_policy的指针变量(AudioPolicyService.h)。而struct audio_policy也是在audio_policy.h中定义,将要用到的接口如下:

struct audio_policy {  
    /* 
     * configuration functions 
     */  
  
    /* indicate a change in device connection status */  
    int (*set_device_connection_state)(struct audio_policy *pol,  
                                       audio_devices_t device,  
                                       audio_policy_dev_state_t state,  
                                       const char *device_address);  
  
    .....  
  
    /* check proper initialization */  
    int (*init_check)(const struct audio_policy *pol);  
  
    .....  
}
接下来看看create_audio_policy()函数指针的具体实现:

static int create_legacy_ap(const struct audio_policy_device *device,  
                            struct audio_policy_service_ops *aps_ops,  
                            void *service,  
                            struct audio_policy **ap)  
{  
    struct legacy_audio_policy *lap;  
    int ret;  
  
    if (!service || !aps_ops)  
        return -EINVAL;  
  
    lap = (struct legacy_audio_policy *)calloc(1, sizeof(*lap));  
    if (!lap)  
        return -ENOMEM;  
  
    lap->policy.set_device_connection_state = ap_set_device_connection_state;  
  
    ......  
  
    lap->policy.init_check = ap_init_check;  
    lap->policy.get_output = ap_get_output;  
    lap->policy.start_output = ap_start_output;  
    lap->policy.stop_output = ap_stop_output;  
    lap->policy.release_output = ap_release_output;  
    lap->policy.get_input = ap_get_input;  
    lap->policy.start_input = ap_start_input;  
    lap->policy.stop_input = ap_stop_input;  
    lap->policy.release_input = ap_release_input;  
  
    .....  

    lap->service = service; // APS
    lap->aps_ops = aps_ops; // 在APS中实现 
    lap->service_client =  
        new AudioPolicyCompatClient(aps_ops, service);
    if (!lap->service_client) {  
        ret = -ENOMEM;  
        goto err_new_compat_client;  
    }  

    lap->apm = createAudioPolicyManager(lap->service_client);
     
    ......  
  
    *ap = &lap->policy;// 将当前音频策略的配置的地址赋值给*ap,并返回给mpAudioPolicy 
  
    ......  
}

此函数中创建了重要对象:AudioPolicyCompatClient类对象和createAudioPolicyManager函数创建音频策略管理器,需要分析下。

先分析AudioPolicyCompatClient类对象的创建。此类在头文件hardware/libhardware_legacy/audio/AudioPolicyCompatClient.h中定义。

namespace android_audio_legacy {  
class AudioPolicyCompatClient : public AudioPolicyClientInterface {   
       // 父类是AudioPolicyClientInterface,与下文中提到的  
       // AudioPolicyManagerBase::  
       // AudioPolicyManagerBase(AudioPolicyClientInterface *clientInterface)类型一致
public:  
    AudioPolicyCompatClient(struct audio_policy_service_ops *serviceOps,  
                            void *service) :  
            mServiceOps(serviceOps) , mService(service) {} // serviceOps = aps_ops,   
                                                           // service = this(APS)
  
    ......  
  
private:  
    struct audio_policy_service_ops* mServiceOps;                     
    void*                            mService;    
  
    ......  
}

此构造函数主要初始化两个私有化变量mServiceOps和mService,并把创建的对象作为函数createAudioPolicyManager的唯一参数,来创建音频策略管理器。
然而,函数createAudioPolicyManager有多个定义,搜索结果如下:

[cpp]  view plain copy print ?
  1. $ grep -rn createAudioPolicyManager hardware/ --exclude-dir=.svn  
  2. hardware/alsa_sound/AudioPolicyManagerALSA.cpp:31:  
  3.           extern "C" android_audio_legacy::AudioPolicyInterface*   
  4.           createAudioPolicyManager(  
  5.           android_audio_legacy::AudioPolicyClientInterface *clientInterface)  
  6. hardware/libhardware_legacy/audio/AudioPolicyManagerDefault.cpp:24:  
  7.           extern "C" AudioPolicyInterface*   
  8.           createAudioPolicyManager(AudioPolicyClientInterface *clientInterface)  
  9. hardware/msm7k/libaudio-qsd8k/AudioPolicyManager.cpp:39:  
  10.           extern "C" AudioPolicyInterface*   
  11.           createAudioPolicyManager(AudioPolicyClientInterface *clientInterface)  
  12. hardware/msm7k/libaudio-qdsp5v2/AudioPolicyManager.cpp:39:  
  13.           extern "C" AudioPolicyInterface*   
  14.           createAudioPolicyManager(AudioPolicyClientInterface *clientInterface)  
  15. hardware/msm7k/libaudio/AudioPolicyManager.cpp:35:  
  16.           extern "C" AudioPolicyInterface*   
  17.           createAudioPolicyManager(AudioPolicyClientInterface *clientInterface)  

函数createAudioPolicyManager虽然有多个定义,但是它们最后将创建AudioPolicyManagerBase类对象,以AudioPolicyManagerALSA类为例分析

AudioPolicyManagerALSA::AudioPolicyManagerALSA(  
    android_audio_legacy::AudioPolicyClientInterface *clientInterface)  
    : AudioPolicyManagerBase(clientInterface) // clientInterface正是  
        // AudioPolicyCompatClient类对象,而AudioPolicyCompatClient类具体实现了  
        // AudioPolicyClientInterface类的需函数接口  
{  
}  
  
AudioPolicyManagerBase::AudioPolicyManagerBase(  
         AudioPolicyClientInterface *clientInterface)  
    :      
#ifdef AUDIO_POLICY_TEST  
    Thread(false),  
#endif //AUDIO_POLICY_TEST  
    mPhoneState(AudioSystem::MODE_NORMAL), mRingerMode(0),  
    mLimitRingtoneVolume(false), mLastVoiceVolume(-1.0f),  
    mTotalEffectsCpuLoad(0), mTotalEffectsMemory(0),  
    mA2dpSuspended(false)  
{  
    mpClientInterface = clientInterface;    // mpClientInterface:将用它回调到APS  
  
    for (int i = 0; i < AudioSystem::NUM_FORCE_USE; i++) {  
        mForceUse[i] = AudioSystem::FORCE_NONE;  
    }      
  
    initializeVolumeCurves();  
  
    loadAudioPolicyConfig("/system/etc/audio_policy.conf")  //add by myself, 构造mHwModules以及mOutputProfiles
    // devices available by default are speaker, ear piece and microphone  
    mAvailableOutputDevices = AudioSystem::DEVICE_OUT_EARPIECE |  
                        AudioSystem::DEVICE_OUT_SPEAKER;          // 可用的输出音频设备
    mAvailableInputDevices = AudioSystem::DEVICE_IN_BUILTIN_MIC;  // 可用的输入音频设备
  
    ......  
    mHwModules[i]->mHandle = mpClientInterface->loadHwModule(mHwModules[i]->mName)  //add by myself
    mHardwareOutput = mpClientInterface->openOutput(&outputDesc->mDevice,  
                                    &outputDesc->mSamplingRate,  
                                    &outputDesc->mFormat,  
                                    &outputDesc->mChannels,  
                                    &outputDesc->mLatency,  
                                    outputDesc->mFlags);  
  
    ......  
  
    setOutputDevice(mHardwareOutput, (uint32_t)AudioSystem::DEVICE_OUT_SPEAKER,   
                                                                              true);  
  
    ......  
  
}  

loadAudioPolicyConfig()函数会解析audio_policy.conf配置文件,参考:http://blog.csdn.net/xuesen_lin/article/details/8805108


mpClientInterface->openOutput()函数先回掉到AudioPolicyCompatClient类的openOutput()函数。

[cpp]  view plain copy print ?
  1. audio_io_handle_t AudioPolicyCompatClient::openOutput(uint32_t *pDevices,  
  2.                                 uint32_t *pSamplingRate,  
  3.                                 uint32_t *pFormat,  
  4.                                 uint32_t *pChannels,  
  5.                                 uint32_t *pLatencyMs,  
  6.                                 AudioSystem::output_flags flags)  
  7. {  
  8.     return mServiceOps->open_output(mService, pDevices, pSamplingRate, pFormat,  
  9.                                     pChannels, pLatencyMs,  
  10.                                     (audio_policy_output_flags_t)flags);  
  11. }

由前面分析可知,在创建AudioPolicyCompatClient类对象时,mServiceOps被初始化为APS的struct audio_policy_service_ops变量aps_ops;则将回调到ops中的open_output()函数,具体调到aps_open_output()函数:

[cpp]  view plain copy print ?
  1. static audio_io_handle_t aps_open_output(void *service,  
  2.                                              uint32_t *pDevices,  
  3.                                              uint32_t *pSamplingRate,  
  4.                                              uint32_t *pFormat,  
  5.                                              uint32_t *pChannels,  
  6.                                              uint32_t *pLatencyMs,  
  7.                                              audio_policy_output_flags_t flags)  
  8. {  
  9.     sp af = AudioSystem::get_audio_flinger();  
  10.     if (af == NULL) {  
  11.         LOGW("%s: could not get AudioFlinger", __func__);  
  12.         return 0;  
  13.     }  
  14.   
  15.     return af->openOutput(pDevices, pSamplingRate, pFormat, pChannels,  
  16.                           pLatencyMs, flags);  
  17. }

不难看出,将调到AudioFlinger的openOutput()函数。

[cpp]  view plain copy print ?
  1. int AudioFlinger::openOutput(uint32_t *pDevices,  
  2.                                 uint32_t *pSamplingRate,  
  3.                                 uint32_t *pFormat,  
  4.                                 uint32_t *pChannels,  
  5.                                 uint32_t *pLatencyMs,  
  6.                                 uint32_t flags)  
  7. {  
  8.      ......  
  9.   
  10.     audio_hw_device_t *outHwDev;  
  11.   
  12.      ......  
  13.   
  14.     outHwDev = findSuitableHwDev_l(*pDevices);  
  15.     if (outHwDev == NULL)  
  16.         return 0;  
  17.   
  18.     status = outHwDev->open_output_stream(outHwDev, *pDevices, (int *)&format,  
  19.                                           &channels, &samplingRate, &outStream);  
  20.   
  21.      ......  
  22.   
  23.     return 0;   
  24. }

struct audio_hw_device_t是在头文件hardware/libhardware/include/hardware/audio.h中定义的一个结构体。

[cpp]  view plain copy print ?
  1. typedef struct audio_hw_device audio_hw_device_t;  

前面在分析AudioFlinger类的load_audio_interface函数时,已经分析过struct audio_hw_device。

[cpp]  view plain copy print ?
  1. audio_hw_device_t* AudioFlinger::findSuitableHwDev_l(uint32_t devices)  
  2. {     
  3.     /* first matching HW device is returned */  
  4.     for (size_t i = 0; i < mAudioHwDevs.size(); i++) {  // 前文分析过,mAudioHwDevs变量保存了HAL层可用音频设备  
  5.         audio_hw_device_t *dev = mAudioHwDevs[i];  
  6.         if ((dev->get_supported_devices(dev) & devices) == devices)   
  7.             return dev;  
  8.     }         
  9.     return NULL;  
  10. }

由前文分析可知,此处的get_supported_devices()函数指针将具体调到audio_hw_hal.cpp文件中的adev_get_supported_devices(),

如下所示,这里列出了系统所支持的所有输出/输入音频设备。因此,我们要也要仿照此音频设备的定义名称,在这里添加USB AUDIO音频设备的名称,以及它们在别处的定义。

[cpp]  view plain copy print ?
  1. static uint32_t adev_get_supported_devices(const struct audio_hw_device *dev)  
  2. {  
  3.     /* XXX: The old AudioHardwareInterface interface is not smart enough to 
  4.      * tell us this, so we'll lie and basically tell AF that we support the 
  5.      * below input/output devices and cross our fingers. To do things properly, 
  6.      * audio hardware interfaces that need advanced features (like this) should 
  7.      * convert to the new HAL interface and not use this wrapper. */  
  8.   
  9.     return (/* OUT */  
  10.             AUDIO_DEVICE_OUT_EARPIECE |  
  11.             AUDIO_DEVICE_OUT_SPEAKER |  
  12.             AUDIO_DEVICE_OUT_WIRED_HEADSET |  
  13.             AUDIO_DEVICE_OUT_WIRED_HEADPHONE |  
  14.             AUDIO_DEVICE_OUT_AUX_DIGITAL |  
  15.             AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET |  
  16.             AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET |  
  17.             AUDIO_DEVICE_OUT_ALL_SCO |  
  18.             AUDIO_DEVICE_OUT_DEFAULT |  
  19.             /* IN */  
  20.             AUDIO_DEVICE_IN_COMMUNICATION |  
  21.             AUDIO_DEVICE_IN_AMBIENT |  
  22.             AUDIO_DEVICE_IN_BUILTIN_MIC |  
  23.             AUDIO_DEVICE_IN_WIRED_HEADSET |  
  24.             AUDIO_DEVICE_IN_AUX_DIGITAL |  
  25.             AUDIO_DEVICE_IN_BACK_MIC |  
  26.             AUDIO_DEVICE_IN_ALL_SCO |  
  27.             AUDIO_DEVICE_IN_DEFAULT);  
  28. }

当找到合适的设备之后,将调用outHwDev->open_output_stream()函数打开相应设备的输出流;

同样的道理,将具体调到audio_hw_hal.cpp文件中的adev_open_output_stream()函数。

[cpp]  view plain copy print ?
  1. static int adev_open_output_stream(struct audio_hw_device *dev,  
  2.                                    uint32_t devices,  
  3.                                    int *format,  
  4.                                    uint32_t *channels,  
  5.                                    uint32_t *sample_rate,  
  6.                                    struct audio_stream_out **stream_out)  
  7. {  
  8.     struct legacy_audio_device *ladev = to_ladev(dev);  
  9.     status_t status;  
  10.     struct legacy_stream_out *out;  
  11.     int ret;  
  12.   
  13.     out = (struct legacy_stream_out *)calloc(1, sizeof(*out));  
  14.     if (!out)  
  15.         return -ENOMEM;  
  16.   
  17.     out->legacy_out = ladev->hwif->openOutputStream(devices, format, channels,  
  18.                                                     sample_rate, &status);  
  19.     ......  
  20. }

由前文分析可知,ladev->hwif具体指AudioHardwareALSA类;则ladev->hwif->openOutputStream()函数调到AudioHardwareALSA::openOutputStream()函数。

[cpp]  view plain copy print ?
  1. android_audio_legacy::AudioStreamOut *  
  2. AudioHardwareALSA::openOutputStream(uint32_t devices,  
  3.                                     int *format,  
  4.                                     uint32_t *channels,  
  5.                                     uint32_t *sampleRate,  
  6.                                     status_t *status)  
  7. {  
  8.     ......  
  9.   
  10.     // Find the appropriate alsa device  
  11.     for(ALSAHandleList::iterator it = mDeviceList.begin(); // mDeviceList是用来存储  
  12.                                                            // 输出/输入音频通道信息的  
  13.                                                            // 句柄的,总共两个句柄,  
  14.                                                            // 分别对应输出和输入音频通道  
  15.         it != mDeviceList.end(); ++it)  
  16.         if (it->devices & devices) {  
  17.             err = mALSADevice->open(&(*it), devices, mode()); // 当调用open()函数时,  
  18.                                                               // 就已经知道要打开的是  
  19.                                                               // 输入音频通道还是输出  
  20.                                                               // 音频通道
  21.             if (err) break;  
  22.             out = new AudioStreamOutALSA(this, &(*it)); // 此类对象的创建本可不必理会,  
  23.                          // 但它的父类ALSAStreamOps类的对象也会随之创建;而ALSAStreamOps  
  24.                          // 类将在后面用到(mParent = this(AudioHardwareALSA))
  25.             err = out->set(format, channels, sampleRate);  
  26.             break;  
  27.         }  
  28.     ......  
  29. }

由前文对AudioHardwareALSA类的启动流程分析可知,mDeviceList是用来存储输出/输入音频通道信息的句柄的。
mALSADevice表示在初始化ALSA设备时所指向的一个具体ALSA设备的操作接口。则mALSADevice->open()函数,将具体调到ALSA模块的s_open()函数。

[cpp]  view plain copy print ?
  1. static status_t s_open(alsa_handle_t *handle, uint32_t devices, int mode)  
  2. {  
  3.     // Close off previously opened device.  
  4.     // It would be nice to determine if the underlying device actually  
  5.     // changes, but we might be recovering from an error or manipulating  
  6.     // mixer settings (see asound.conf).  
  7.     //  
  8.     s_close(handle); // 先关闭先前打开的音频通道  
  9.     LOGD("open called for devices %08x in mode %d...", devices, mode);  
  10.   
  11.     const char *stream = streamName(handle);    
  12.     const char *devName = deviceName(handle, devices, mode);  
  13.   
  14.     int err;  
  15.   
  16.     for (;;) {  
  17.         // The PCM stream is opened in blocking mode, per ALSA defaults.  The  
  18.         // AudioFlinger seems to assume blocking mode too, so asynchronous mode  
  19.         // should not be used.  
  20.         err = snd_pcm_open(&handle->handle, devName, direction(handle),    // handle->handle:保存从ALSA-LIB中获得的PCM节点
  21.                            SND_PCM_ASYNC); 
  22.         if (err == 0) break;  
  23.         // See if there is a less specific name we can try.  
  24.         // Note: We are changing the contents of a const char * here.  
  25.         char *tail = strrchr(devName, '_');  
  26.         if (!tail) break;  
  27.         *tail = 0;  
  28.     }  
  29.   
  30.     if (err < 0) {  
  31.         // None of the Android defined audio devices exist. Open a generic one.  
  32.         devName = "default";
  33.         err = snd_pcm_open(&handle->handle, devName, direction(handle), 0);  
  34.     }  
  35.     if (err < 0) {  
  36.         LOGE("Failed to Initialize any ALSA %s device: %s",  
  37.                 stream, strerror(err));  
  38.         return NO_INIT;  
  39.     }  
  40.   
  41.     err = setHardwareParams(handle);  
  42.   
  43.     if (err == NO_ERROR) err = setSoftwareParams(handle);  
  44.   
  45.     LOGI("Initialized ALSA %s device %s", stream, devName);  
  46.   
  47.     handle->curDev = devices;  
  48.     handle->curMode = mode;  
  49.   
  50.     return err;  
  51. }  

(1) 调用函数streamName()函数获取音频流名称。

[cpp]  view plain copy print ?
  1. const char *streamName(alsa_handle_t *handle)  
  2. {     
  3.     return snd_pcm_stream_name(direction(handle));  
  4. }

snd_pcm_stream_name()函数是ALSA-LIB API,在external/alsa-lib/src/pcm/pcm.c文件中定义。
要想获得音频流名称,不得不先分析direction()函数。

[cpp]  view plain copy print ?
  1. snd_pcm_stream_t direction(alsa_handle_t *handle)  
  2. {  
  3.     return (handle->devices & android_audio_legacy::AudioSystem::DEVICE_OUT_ALL) ? SND_PCM_STREAM_PLAYBACK  
  4.             : SND_PCM_STREAM_CAPTURE;  
  5. }

原来direction()函数就是用来返回PCM流的方向(放音或者录音)。
direction()函数的返回值将作为snd_pcm_stream_name()的参数,

[cpp]  view plain copy print ?
  1. const char *snd_pcm_stream_name(snd_pcm_stream_t stream)  
  2. {  
  3.         if (stream > SND_PCM_STREAM_LAST)   
  4.                 return NULL;  
  5.         return snd_pcm_stream_names[stream];  
  6. }

[cpp]  view plain copy print ?
  1. static const char *const snd_pcm_stream_names[] = {  
  2.         STREAM(PLAYBACK),  
  3.         STREAM(CAPTURE),  
  4. };
好吧,音频流的名称不是放音就是录音。

(2)接下来调用deviceName()函数获取设备名称。这点很重要,将为我们在asound.conf为新添加的USB AUDIO音频设备命名提供规则。

[cpp]  view plain copy print ?
  1. const char *deviceName(alsa_handle_t *handle, uint32_t device, int mode)  
  2. {  
  3.     static char devString[ALSA_NAME_MAX];  
  4.     int hasDevExt = 0;  
  5.   
  6.     strcpy(devString, devicePrefix[direction(handle)]);  
  7.   
  8.     for (int dev = 0; device && dev < deviceSuffixLen; dev++)  
  9.         if (device & deviceSuffix[dev].device) {  
  10.             ALSA_STRCAT (devString, deviceSuffix[dev].suffix);  
  11.             device &= ~deviceSuffix[dev].device;  
  12.             hasDevExt = 1;
  13.         }  
  14.   
  15.     if (hasDevExt) switch (mode) {  
  16.     case android_audio_legacy::AudioSystem::MODE_NORMAL:  
  17.         ALSA_STRCAT (devString, "_normal");  
  18.         break;  
  19.     case android_audio_legacy::AudioSystem::MODE_RINGTONE:  
  20.         ALSA_STRCAT (devString, "_ringtone");  
  21.         break;  
  22.     case android_audio_legacy::AudioSystem::MODE_IN_CALL:  
  23.         ALSA_STRCAT (devString, "_incall");  
  24.         break;  
  25.     };  
  26.   
  27.     return devString;  
  28. }
用字符数组devString存储设备名称。
首先把设备前缀复制给devString。因此,作为输出音频通道设备的名称,必以AndroidPlayback为前缀;作为输入音频通道设备的名称,必以AndroidCapture为前缀。

[cpp]  view plain copy print ?
  1. static const char *devicePrefix[SND_PCM_STREAM_LAST + 1] = {  
  2.         /* SND_PCM_STREAM_PLAYBACK : */"AndroidPlayback",  
  3.         /* SND_PCM_STREAM_CAPTURE  : */"AndroidCapture",  
  4. };

接下来从deviceSuffix数组中查找合适的后缀,追加到devString字符数组中。

[cpp]  view plain copy print ?
  1. /* The following table(s) need to match in order of the route bits 
  2.  */       
  3. static const device_suffix_t deviceSuffix[] = {  
  4.         {android_audio_legacy::AudioSystem::DEVICE_OUT_EARPIECE,       "_Earpiece"},  
  5.         {android_audio_legacy::AudioSystem::DEVICE_OUT_SPEAKER,        "_Speaker"},  
  6.         {android_audio_legacy::AudioSystem::DEVICE_OUT_BLUETOOTH_SCO,  "_Bluetooth"},  
  7.         {android_audio_legacy::AudioSystem::DEVICE_OUT_WIRED_HEADSET,  "_Headset"},  
  8.         {android_audio_legacy::AudioSystem::DEVICE_OUT_BLUETOOTH_A2DP, "_Bluetooth-A2DP"},  
  9. };

struct device_suffix_t的定义如下:

[cpp]  view plain copy print ?
  1. struct device_suffix_t {  
  2.     const android_audio_legacy::AudioSystem::audio_devices device;  
  3.     const char *suffix;  
  4. };

PS: 我们也要在此数组中添加USB AUDIO音频设备的相关信息。同时也要在定义了类似DEVICE_OUT_EARPIECE设备的类中定义USB AUDIO音频设备:

[cpp]  view plain copy print ?
  1.     1.frameworks/base/media/java/android/media/AudioSystem.java  
  2.     2.frameworks/base/media/java/android/media/AudioManager.java  
  3.     3.hardware/libhardware_legacy/include/hardware_legacy/AudioSystemLegacy.h  
  4.     4.system/core/include/system/audio.h  

题外话:android系统中对音频设备的定义如下(AudioSystem.java):

[cpp]  view plain copy print ?
  1.     public static final int DEVICE_OUT_EARPIECE = 0x1; // 0x1 << 0  
  2.     public static final int DEVICE_OUT_SPEAKER = 0x2;  // 0x1 << 1  
  3.     public static final int DEVICE_OUT_WIRED_HEADSET = 0x4; // 0x1 << 2  
  4.     public static final int DEVICE_OUT_WIRED_HEADPHONE = 0x8; // 0x1 << 3  
  5.     public static final int DEVICE_OUT_BLUETOOTH_SCO = 0x10; // 0x1 << 4  
  6.     public static final int DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 0x20; // 0x1 << 5  
  7.     public static final int DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 0x40; // 0x1 << 6  
  8.     public static final int DEVICE_OUT_BLUETOOTH_A2DP = 0x80; // 0x1 << 7  
  9.     public static final int DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100;  
  10.                                                                       // 0x100 << 0  
  11.     public static final int DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 0x200; // 0x100 << 1  
  12.     public static final int DEVICE_OUT_AUX_DIGITAL = 0x400; // 0x100 << 2  
  13.     public static final int DEVICE_OUT_ANLG_DOCK_HEADSET = 0x800; // 0x100 << 3  
  14.     public static final int DEVICE_OUT_DGTL_DOCK_HEADSET = 0x1000; // 0x1000 << 0  
  15.     public static final int DEVICE_OUT_DEFAULT = 0x8000; // 0x1000 << 3  
  16.     // input devices  
  17.     public static final int DEVICE_IN_COMMUNICATION = 0x10000; // 0x10000 << 0  
  18.     public static final int DEVICE_IN_AMBIENT = 0x20000; // 0x10000 << 1  
  19.     public static final int DEVICE_IN_BUILTIN_MIC1 = 0x40000; // 0x10000 << 2  
  20.     public static final int DEVICE_IN_BUILTIN_MIC2 = 0x80000; // 0x10000 << 3  
  21.     public static final int DEVICE_IN_MIC_ARRAY = 0x100000; // 0x100000 << 0  
  22.     public static final int DEVICE_IN_BLUETOOTH_SCO_HEADSET = 0x200000;   
  23.                                                                     // 0x100000 << 1  
  24.     public static final int DEVICE_IN_WIRED_HEADSET = 0x400000; // 0x100000 << 2  
  25.     public static final int DEVICE_IN_AUX_DIGITAL = 0x800000; // 0x100000 << 3  

当设备越来越多时,很难保证等号右边的数字中零的个数不写错。采用注释部分的定义方式较好。

当找到了设备后缀后,将对变量hasDevExt赋值为1,表示还会有扩展名称(_normal,_ringtone或者_incall)。

至此,一个设备的PCM节点名称就形成了!

(3)程序将执行到调用snd_pcm_open() ALSA-LIB API,并把刚才得到的设备名称devName作为参数之一,调到ALSA-LIB,进而调到ALSA-DRIVER,去打开所指定的音频设备。如果打开指定的音频设备失败了,将打开默认的音频设备。

(4)如果成功打开音频设备,程序继续往下执行,将调用setHardwareParams()函数设置硬件参数。这些硬件参数包括缓冲区大小,采样率,声道数和音频格式等。其实这些硬件参数都在struct alsa_handle_t中定义,在分析初始化函数s_init()函数时已有分析,在默认音频设备配置_defaultsOut和_defaultsIn中已经指定。


但是,在使用USB AUDIO输入音频设备时,默认的输入音频配置中的声道数和采样率很有可能与实际使用的USB AUDIO的不一致,导致USB AUDIO设备不可用或者音频失真。因此,需要在执行setHardwareParams()函数前,并且知道是要打开输入音频通道时(输出音频通道的硬件参数配置可用),需要检测时间使用的USB AUDIO音频设备的这两个硬件参数,重新对_defaultsIn中声道数和采样率进行赋值。将在后面做详细分析。

[cpp]  view plain copy print ?
  1. status_t setHardwareParams(alsa_handle_t *handle)  
  2. {  
  3.     ......  
  4.   
  5.     unsigned int requestedRate = handle->sampleRate;  
  6.   
  7.     ......  
  8.   
  9.     err = snd_pcm_hw_params_set_channels(handle->handle, hardwareParams,  
  10.                        handle->channels);  
  11.   
  12.     ......  
  13.   
  14.     err = snd_pcm_hw_params_set_rate_near(handle->handle, hardwareParams,  
  15.             &requestedRate, 0);  
  16.   
  17.     ......  
  18. }  

(5)最后程序会执行到设置软件参数的函数setHardwareParams()中。在添加USB AUDIO音频设备时,这里没有遇到问题,不再分析。


2. JAVA API setDeviceConnectionState()调用流程详解。

把最复杂的两大本地服务分析完后,后面的任务就很轻了!
JAVA API setDeviceConnectionState()在文件frameworks/base/media/java/android/media/AudioSystem.java中定义。
    public static native int setDeviceConnectionState(int device, int state, String device_address);
第一个参数就是要打开的音频设备的标识符,将一路传递下去,直到ALSA模块(alsa_default.cpp);
第二个参数表示第一个参数所指的音频设备是否可用;
第三个参数表示设备地址,一般为空。

看到java关键字native,晓得将调到对应的JNI(frameworks/base/core/jni/android_media_AudioSystem.cpp)代码。


[cpp]  view plain copy print ?
  1. static int   
  2. android_media_AudioSystem_setDeviceConnectionState(JNIEnv *env, jobject thiz,   
  3.                                   jint device, jint state, jstring device_address)  
  4. {  
  5.     const char *c_address = env->GetStringUTFChars(device_address, NULL);  
  6.     int status = check_AudioSystem_Command(  
  7.        AudioSystem::setDeviceConnectionState(static_cast (device),  
  8.        static_cast (state),  
  9.        c_address));  
  10.     env->ReleaseStringUTFChars(device_address, c_address);  
  11.     return status;  
  12. }

显然,又调到libmedia库(frameworks/base/media/libmedia/AudioSystem.cpp)中setDeviceConnectionState()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="font-size:24px;">status_t AudioSystem::setDeviceConnectionState(audio_devices_t device,  
  2.                                                audio_policy_dev_state_t state,  
  3.                                                const char *device_address)  
  4. {  
  5.     const sp& aps = AudioSystem::get_audio_policy_service();  
  6.     const char *address = "";   
  7.   
  8.     if (aps == 0) return PERMISSION_DENIED;  
  9.   
  10.     if (device_address != NULL) {  
  11.         address = device_address;  
  12.     }     
  13.   
  14.     return "color:#ff0000;">aps->setDeviceConnectionState(device, state, address);  
  15. }  


显然,调到APS的setDeviceConnectionState()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="font-size:24px;">status_t AudioPolicyService::setDeviceConnectionState(audio_devices_t device,  
  2.                                                   audio_policy_dev_state_t state,  
  3.                                                   const char *device_address)  
  4. {  
  5.     ......  
  6.   
  7.     return "color:#ff0000;">mpAudioPolicy->set_device_connection_state(mpAudioPolicy, device,  
  8.                                                       state, device_address);  
  9. }  
  10.   


根据前面对AudioPolicyService服务的启动流程分析可知,mpAudioPolicy指向在文件audio_policy_hal.cpp中定义的音频策略模块。则mpAudioPolicy->set_device_connection_state()函数具体调到函数ap_set_device_connection_state()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="font-size:24px;">static int ap_set_device_connection_state(struct audio_policy *pol,  
  2.                                           audio_devices_t device,          
  3.                                           audio_policy_dev_state_t state,  
  4.                                           const char *device_address)      
  5. {  
  6.     struct legacy_audio_policy *lap = to_lap(pol);  
  7.     return "color:#ff0000;">lap->apm->setDeviceConnectionState(  
  8.                     (AudioSystem::audio_devices)device,  
  9.                     (AudioSystem::device_connection_state)state,  
  10.                     device_address);                 
  11. }  


同样,由前面对AudioPolicyService服务的启动流程分析可知,lap->apm指向AudioPolicyManagerBase类对象。则lap->apm->setDeviceConnectionState()函数将调到AudioPolicyManagerBase::setDeviceConnectionState()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="font-size: 24px;">"font-size:18px;">status_t AudioPolicyManagerBase::setDeviceConnectionState(AudioSystem::audio_devices device,  
  2.                                                   AudioSystem::device_connection_state state,  
  3.                                                   const char *device_address)  
  4. {  
  5.     ......  
  6.   
  7.     // handle output devices  
  8.     if (AudioSystem::isOutputDevice(device)) {   "font-size:18px;color:#3333ff;">// 如果是输出设备  
  9. "font-size:18px;">  
  10.     ......  
  11.   
  12.         switch (state)  
  13.        {  
  14.         // handle output device connection  
  15.         case AudioSystem::DEVICE_STATE_AVAILABLE:  
  16.             if (mAvailableOutputDevices & device) {  
  17.                 LOGW("setDeviceConnectionState() device already connected: %x", device);  
  18.                 return INVALID_OPERATION;  
  19.             }  
  20.             LOGV("setDeviceConnectionState() connecting device %x", device);  
  21.   
  22.             // register new device as available  
  23.             mAvailableOutputDevices |= device;   "color:#3333ff;">// 把当前设备加入到可用设备变量中  
  24.   
  25.         .....  
  26.   
  27.         // handle output device disconnection  
  28.         case AudioSystem::DEVICE_STATE_UNAVAILABLE: {  
  29.             if (!(mAvailableOutputDevices & device)) {  
  30.                 LOGW("setDeviceConnectionState() device not connected: %x", device);  
  31.                 return INVALID_OPERATION;  
  32.             }  
  33.   
  34.   
  35.             LOGV("setDeviceConnectionState() disconnecting device %x", device);  
  36.             // remove device from available output devices  
  37.             mAvailableOutputDevices &= ~device; "color:#3333ff;">// 把当前设备从可用设备变量中去除  
  38.   
  39.         ......  
  40.         }  
  41.   
  42.         // request routing change if necessary  
  43.         uint32_t newDevice = "color:#ff0000;">getNewDevice(mHardwareOutput, false);  
  44.    
  45.         ......  
  46.   
  47.         "color:#ff0000;">updateDeviceForStrategy();  
  48.         "font-size:24px;">"background-color: rgb(153, 153, 153);">"color:#ff0000;">setOutputDevice(mHardwareOutput, newDevice);  
  49.   
  50.         "color:#3333ff;">// 如果输出音频设备是USB AUDIO(USB 放音),那么应该知道输入音频设备为SUB MIC  
  51.         if (device == AudioSystem::DEVICE_OUT_WIRED_HEADSET) {  
  52.             device = AudioSystem::DEVICE_IN_WIRED_HEADSET;  
  53.        } else if (device == AudioSystem::DEVICE_OUT_BLUETOOTH_SCO ||  
  54.                    device == AudioSystem::DEVICE_OUT_BLUETOOTH_SCO_HEADSET ||  
  55.                    device == AudioSystem::DEVICE_OUT_BLUETOOTH_SCO_CARKIT) {  
  56.             device = AudioSystem::DEVICE_IN_BLUETOOTH_SCO_HEADSET;  
  57.         } else {  
  58.             return NO_ERROR;  
  59.         }  
  60.     }  
  61.     // handle input devices  
  62.     if (AudioSystem::isInputDevice(device)) { "color:#3333ff;">// 如果是输入设备  
  63.   
  64.         switch (state)  
  65.         {  
  66.         // handle input device connection  
  67.         case AudioSystem::DEVICE_STATE_AVAILABLE: {  
  68.            if (mAvailableInputDevices & device) {  
  69.                 LOGW("setDeviceConnectionState() device already connected: %d", device);  
  70.                 return INVALID_OPERATION;  
  71.             }  
  72.             mAvailableInputDevices |= device;  
  73.             }  
  74.             break;  
  75.   
  76.         // handle input device disconnection  
  77.         case AudioSystem::DEVICE_STATE_UNAVAILABLE: {  
  78.             if (!(mAvailableInputDevices & device)) {  
  79.                 LOGW("setDeviceConnectionState() device not connected: %d", device);  
  80.                 return INVALID_OPERATION;  
  81.             }  
  82.             mAvailableInputDevices &= ~device;  
  83.             } break;  
  84.   
  85.         default:  
  86.             LOGE("setDeviceConnectionState() invalid state: %x", state);  
  87.             return BAD_VALUE;  
  88.         }  
  89.   
  90.         audio_io_handle_t activeInput = getActiveInput();  
  91.         if (activeInput != 0) {  
  92.             AudioInputDescriptor *inputDesc = mInputs.valueFor(activeInput);  
  93.             uint32_t newDevice = getDeviceForInputSource(inputDesc->mInputSource);  
  94.             if (newDevice != inputDesc->mDevice) {  
  95.                 LOGV("setDeviceConnectionState() changing device from %x to %x for input %d",  
  96.                         inputDesc->mDevice, newDevice, activeInput);  
  97.                 inputDesc->mDevice = newDevice;  
  98.                 AudioParameter param = AudioParameter();  
  99.                 param.addInt(String8(AudioParameter::keyRouting), (int)newDevice);  
  100.                 mpClientInterface->setParameters(activeInput, param.toString());  
  101.             }  
  102.         }  
  103.   
  104.         return NO_ERROR;  
  105.     }  
  106.   
  107.     LOGW("setDeviceConnectionState() invalid device: %x", device);  
  108.     return BAD_VALUE;  
  109. }  
  110.   


(1) 当前设备是输出设备时,程序执行到getNewDevice()函数,将获得新设备,作为设置输出设备函数setOutputDevice()的第二个参数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">uint32_t AudioPolicyManagerBase::getNewDevice(audio_io_handle_t output, bool fromCache)  
  2. {  
  3.     uint32_t device = 0;  
  4.   
  5.     AudioOutputDescriptor *outputDesc = mOutputs.valueFor(output);  
  6.     // check the following by order of priority to request a routing change if necessary:  
  7.     // 1: the strategy enforced audible is active on the output:  
  8.     //      use device for strategy enforced audible  
  9.     // 2: we are in call or the strategy phone is active on the output:  
  10.     //      use device for strategy phone  
  11.     // 3: the strategy sonification is active on the output:  
  12.     //      use device for strategy sonification  
  13.     // 4: the strategy media is active on the output:  
  14.     //      use device for strategy media  
  15.     // 5: the strategy DTMF is active on the output:  
  16.     //      use device for strategy DTMF  
  17.     if (outputDesc->"color:#ff0000;">isUsedByStrategy(STRATEGY_ENFORCED_AUDIBLE)) { "color:#3333ff;">// 判断是否使用了这五种音频策略之一的  
  18.                                                                    // STRATEGY_ENFORCED_AUDIBLE  
  19.         device = "color:#ff0000;">getDeviceForStrategy(STRATEGY_ENFORCED_AUDIBLE, fromCache);  "color:#3333ff;">// 若使用了STRATEGY_ENFORCED_AUDIBLE,  
  20.                                                                         // 并获得相关设备,需要增加对USB AUDIO设备的支持  
  21.     } else if (isInCall() ||  
  22.                     outputDesc->isUsedByStrategy(STRATEGY_PHONE)) {  
  23.         device = getDeviceForStrategy(STRATEGY_PHONE, fromCache);  
  24.     } else if (outputDesc->isUsedByStrategy(STRATEGY_SONIFICATION)) {  
  25.         device = getDeviceForStrategy(STRATEGY_SONIFICATION, fromCache);  
  26.     } else if (outputDesc->isUsedByStrategy(STRATEGY_MEDIA)) {  
  27.         device = getDeviceForStrategy(STRATEGY_MEDIA, fromCache);  
  28.     } else if (outputDesc->isUsedByStrategy(STRATEGY_DTMF)) {  
  29.         device = getDeviceForStrategy(STRATEGY_DTMF, fromCache);  
  30.     }  
  31.      
  32.     ......  
  33.   
  34.     return device;  
  35. }  
  36.   
  37. ......  
  38.   
  39.   
  40. uint32_t AudioPolicyManagerBase::getDeviceForStrategy(routing_strategy strategy, bool fromCache)  
  41. {  
  42.     uint32_t device = 0;  
  43.   
  44.     if (fromCache) {  
  45.         LOGV("getDeviceForStrategy() from cache strategy %d, device %x", strategy, mDeviceForStrategy[strategy]);  
  46.         return mDeviceForStrategy[strategy];  
  47.     }  
  48.   
  49.     switch (strategy) {  
  50.     case STRATEGY_DTMF:   
  51.         if (!isInCall()) {  
  52.             // when off call, DTMF strategy follows the same rules as MEDIA strategy  
  53.             device = getDeviceForStrategy(STRATEGY_MEDIA, false);  
  54.             break;  
  55.         }  
  56.         // when in call, DTMF and PHONE strategies follow the same rules  
  57.         // FALL THROUGH  
  58.   
  59.     case STRATEGY_PHONE:   "color:#3333ff;">// 由于我BOX不支持通话功能,所以可以不在此策略下添加对USB AUDIO设备的支持  
  60.         // for phone strategy, we first consider the forced use and then the available devices by order  
  61.         // of priority  
  62.   
  63.     ......  
  64.   
  65.     break;  
  66.   
  67.     case STRATEGY_SONIFICATION: "color:#3333ff;">// 由于我BOX不支持通话功能,所以可以不在此策略下添加对USB AUDIO设备的支持  
  68.   
  69.         // If incall, just select the STRATEGY_PHONE device: The rest of the behavior is handled by  
  70.         // handleIncallSonification().  
  71.   
  72.      ......  
  73.   
  74.     case STRATEGY_ENFORCED_AUDIBLE:  
  75.         // strategy STRATEGY_ENFORCED_AUDIBLE uses same routing policy as STRATEGY_SONIFICATION  
  76.         // except when in call where it doesn't default to STRATEGY_PHONE behavior  
  77.   
  78.     ......  
  79.   
  80.     case STRATEGY_MEDIA: { "color:#3333ff;">// 多媒体播放策略,需要添加对USB AUDIO设备的支持  
  81.         uint32_t device2 = mAvailableOutputDevices & AudioSystem::DEVICE_OUT_WIRED_HEADPHONE;  
  82.         if (device2 == 0) {  
  83.             device2 = mAvailableOutputDevices & AudioSystem::DEVICE_OUT_WIRED_HEADSET;  
  84.         }  
  85.   
  86.     .......  
  87.   
  88.         "color:#3333ff;">// 添加对USB AUDIO设备支持的代码  
  89. "color:#33cc00;">        if (device2 == 0) {  
  90.             device2 = mAvailableOutputDevices & AudioSystem::DEVICE_OUT_USB_AUDIO;  
  91.         }  
  92.         "color:#3333ff;">// end  
  93.   
  94.         .......  
  95. }  


(2)获取到新设备后,程序继续向下执行到updateDeviceForStrategy()函数,根据音频策略更新了相应的设备。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">void AudioPolicyManagerBase::updateDeviceForStrategy()  
  2. {  
  3.     for (int i = 0; i < NUM_STRATEGIES; i++) {  
  4.         mDeviceForStrategy[i] = "color:#ff0000;">getDeviceForStrategy((routing_strategy)i, false);  
  5.     }    
  6. }  


由于此函数仍将调到刚刚分析的函数getDeviceForStrategy(),故不再深入分析。

(3)更新完设备后,程序继续向下执行到setOutputDevice()函数,用新获取到的设备名称作为第二个参数(第一个参数是在创建AudioPolicyManagerBase类对象时获得的输出音频通道),来设置输出设备。此函数很重要,它将调到ALSA模块(alsa_default.cpp)。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">void AudioPolicyManagerBase::setOutputDevice(audio_io_handle_t output, uint32_t device, bool force, int delayMs)  
  2. {             
  3.     LOGV("setOutputDevice() output %d device %x delayMs %d", output, device, delayMs);  
  4.     AudioOutputDescriptor *outputDesc = mOutputs.valueFor(output);   
  5.                      
  6.     ......  
  7.   
  8.     // do the routing  
  9.     AudioParameter param = AudioParameter();  
  10.     param.addInt(String8(AudioParameter::keyRouting), (int)device);  "color:#3333ff;">// 第一个参数,暗示将重新选择路由,  
  11.                                                                      // 第二个参数就是要打开的音频设备的标识符  
  12.     mpClientInterface->setParameters(mHardwareOutput, param.toString(), delayMs);  "color:#3333ff;">// 将从HAL层调回到frameworks层  
  13.   
  14.     ......  
  15. }  


调用函数setOutputDevice()时,明明只有两个参数,怎么函数原型却有4个参数了那。有点儿诡异吧!我也困惑了好大会儿。最后才发现此函数的声明(AudioPolicyManagerBase.h)中,最后两个参数(第三个和第四个参数)已经有了默认值。原来,C++中有了默认值的参数,在调用时可以不写出来!!!
        void setOutputDevice(audio_io_handle_t output, uint32_t device, bool force = false, int delayMs = 0);
此函数的重点在于调用了函数mpClientInterface->setParameters()。
第一个参数mHardwareOutput:表示输出音频通道,
第三个参数delayMs:表示等待时间,值为默认值0。

通过前文分析可知,mpClientInterface就是AudioPolicyCompatClient类的对象,则mpClientInterface->setParameters()函数将调到AudioPolicyCompatClient类的setParameters()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="font-size:24px;">void AudioPolicyCompatClient::setParameters(audio_io_handle_t ioHandle,  
  2.                                             const String8& keyValuePairs,  
  3.                                             int delayMs)  
  4. {  
  5.     "color:#ff0000;">mServiceOps->set_parameters(mService, ioHandle, keyValuePairs.string(),    
  6. "color:#3333ff;">  // 在创建APS类对象时,调用create_audio_policy()第三个参数this(即APS)一路传递下来,并在创建  
  7.   // AudioPolicyCompatClient类对象时对mService进行了初始化  
  8.                            delayMs);  
  9. }  

而mServiceOps在创建AudioPolicyCompatClient类对象时,指向APS的struct audio_policy_service_ops变量aps_ops。则mServiceOps->set_parameters()函数将调到APS的aps_set_parameters()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="font-size:24px;">static void aps_set_parameters(void *service, audio_io_handle_t io_handle,  
  2.                                    const char *kv_pairs, int delay_ms)  
  3. {  
  4.     AudioPolicyService *audioPolicyService = (AudioPolicyService *)service;  
  5.   
  6.     audioPolicyService->setParameters(io_handle, kv_pairs, delay_ms);  
  7. }  


显然将调到APS类的setParameters()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="font-size:24px;">void AudioPolicyService::setParameters(audio_io_handle_t ioHandle,  
  2.                                        const char *keyValuePairs,       
  3.                                        int delayMs)                     
  4. {  
  5.     "color:#ff0000;">mAudioCommandThread->parametersCommand((int)ioHandle, keyValuePairs,  
  6.                                            delayMs);                        
  7. }  



mAudioCommandThread就是在创建APS类对象时,启动的一个音频命令线程。函数mAudioCommandThread->parametersCommand()将根据第二个参数产生一个设置音频参数的命令,并发给此线程的处理函数threadLoop()。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">status_t AudioPolicyService::AudioCommandThread::parametersCommand(int ioHandle,  
  2.                                                                    const char *keyValuePairs,  
  3.                                                                    int delayMs)  
  4. {  
  5.     status_t status = NO_ERROR;  
  6.                                              
  7.     AudioCommand *command = new AudioCommand();  
  8.     "color:#ff0000;">command->mCommand = SET_PARAMETERS;  
  9.     ParametersData *data = new ParametersData();  
  10.     data->mIO = ioHandle;                 
  11.     "color:#ff0000;">data->mKeyValuePairs = String8(keyValuePairs);  "color:#3333ff;">// keyValuePairs保存了从AudioPolicyManagerBase类传递的音频参数param  
  12.     command->mParam = data;               
  13.     if (delayMs == 0) {  
  14.         command->mWaitStatus = true;  
  15.     } else {                                         
  16.         command->mWaitStatus = false;  
  17.     }  
  18.     Mutex::Autolock _l(mLock);  
  19.     insertCommand_l(command, delayMs); "color:#3333ff;">// 调用函数insertCommand_l()把命令插入到此线程处理函数threadLoop()中  
  20.   
  21.     ......  
  22.   
  23. }  
  24.   


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">// insertCommand_l() must be called with mLock held  
  2. void AudioPolicyService::AudioCommandThread::insertCommand_l(AudioCommand *command, int delayMs)  
  3. {  
  4.     ......  
  5.   
  6.     // acquire wake lock to make sure delayed commands are processed  
  7.     if (mName != "" && "color:#ff0000;">mAudioCommands.isEmpty()) {  
  8.         acquire_wake_lock(PARTIAL_WAKE_LOCK, mName.string());  
  9.     }  
  10.   
  11.     // check same pending commands with later time stamps and eliminate them  
  12.     for (i = mAudioCommands.size()-1; i >= 0; i--) {  
  13.         "color:#ff0000;">AudioCommand *command2 = mAudioCommands[i];  
  14.   
  15.     ......  
  16.   
  17.         switch (command->mCommand) {  
  18.         "color:#ff0000;">case SET_PARAMETERS: {  
  19.             ParametersData *data = (ParametersData *)command->mParam;  
  20.             ParametersData *data2 = (ParametersData *)command2->mParam;  
  21.             if (data->mIO != data2->mIO) break;  
  22.             LOGV("Comparing parameter command %s to new command %s",  
  23.                     data2->mKeyValuePairs.string(), data->mKeyValuePairs.string());  
  24.             AudioParameter param = AudioParameter(data->mKeyValuePairs);  
  25.             AudioParameter param2 = AudioParameter(data2->mKeyValuePairs);  
  26.             for (size_t j = 0; j < param.size(); j++) {  
  27.                String8 key;  
  28.                String8 value;  
  29.                param.getAt(j, key, value);  
  30.                for (size_t k = 0; k < param2.size(); k++) {  
  31.                   String8 key2;  
  32.                   String8 value2;  
  33.                   param2.getAt(k, key2, value2);  
  34.                   if (key2 == key) {  
  35.                       param2.remove(key2);  
  36.                       LOGV("Filtering out parameter %s", key2.string());  
  37.                       break;  
  38.                   }  
  39.                }  
  40.             }  
  41.             // if all keys have been filtered out, remove the command.  
  42.             // otherwise, update the key value pairs  
  43.             if (param2.size() == 0) {  
  44.                 "color:#ff0000;">removedCommands.add(command2);  
  45.             } else {  
  46.                 data2->mKeyValuePairs = param2.toString();  
  47.             }  
  48.         } break;  
  49.   
  50.     ......  
  51. }  

插入命令函数AudioCommandThread::insertCommand_l()和命令处理函数AudioCommandThread::threadLoop()的衔接点就是mAudioCommands列表。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">bool AudioPolicyService::AudioCommandThread::threadLoop()  
  2. {  
  3.     nsecs_t waitTime = INT64_MAX;  
  4.   
  5.     mLock.lock();  
  6.     while (!exitPending())  
  7.     {  
  8.         while(!mAudioCommands.isEmpty()) {  
  9.             nsecs_t curTime = systemTime();  
  10.             // commands are sorted by increasing time stamp: execute them from index 0 and up  
  11.             if (mAudioCommands[0]->mTime <= curTime) {  
  12.                 "color:#ff0000;">AudioCommand *command = mAudioCommands[0];  
  13.                 mAudioCommands.removeAt(0);  
  14.                 mLastCommand = *command;  
  15.   
  16.                 switch (command->mCommand) {  
  17.     ......  
  18.   
  19.                 case SET_PARAMETERS: {  
  20.                      ParametersData *data = (ParametersData *)command->mParam;  
  21.                      LOGV("AudioCommandThread() processing set parameters string %s, io %d",  
  22.                              data->mKeyValuePairs.string(), data->mIO);  
  23.                      command->mStatus = "color:#ff0000;">AudioSystem::setParameters(data->mIO, data->mKeyValuePairs);  
  24.                      if (command->mWaitStatus) {  
  25.                          command->mCond.signal();  
  26.                          mWaitWorkCV.wait(mLock);  
  27.                      }  
  28.                      delete data;  
  29.                      }break;  
  30.     ......  
  31.   
  32. }  


此线程处理函数并没有真正去设置参数,而是把设置参数的实际操作交给了函数AudioSystem::setParameters()。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">status_t AudioSystem::setParameters(audio_io_handle_t ioHandle, const String8& keyValuePairs) {  
  2.     const sp& af = AudioSystem::get_audio_flinger();  
  3.     if (af == 0) return PERMISSION_DENIED;  
  4.     return "color:#ff0000;">af->setParameters(ioHandle, keyValuePairs);  
  5. }  


又调到AudioFlinger了!


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">status_t AudioFlinger::setParameters(int ioHandle, const String8& keyValuePairs)    
  2. {  
  3.   
  4.     ......  
  5.   
  6.    // check calling permissions  
  7.     if (!settingsAllowed()) {  
  8.         return PERMISSION_DENIED;  
  9.     }  
  10.   
  11.     // ioHandle == 0 means the parameters are global to the audio hardware interface  
  12.     if (ioHandle == 0) {  "color:#ff0000;">"color:#3333ff;">// ioHandle就是在函数AudioPolicyManagerBase::setOutputDevice()内调用  
  13.                           // mpClientInterface->setParameters()函数时,  
  14.                           // 传递的第一个参数mHardwareOutput,其值有其中可能;经查看log信息确认,当前值是0。  
  15.                           // 将改变全局输入/输出音频设备  
  16.         AutoMutex lock(mHardwareLock);  
  17.         mHardwareStatus = AUDIO_SET_PARAMETER;  
  18.         status_t final_result = NO_ERROR;  
  19.         for (size_t i = 0; i < mAudioHwDevs.size(); i++) {  // 将对所有的音频设备的参数都重新设置  
  20.             audio_hw_device_t *dev = "color:#ff0000;">mAudioHwDevs[i];  
  21.             result = "color:#ff0000;">dev->set_parameters(dev, keyValuePairs.string());  
  22.             final_result = result ?: final_result;  
  23.         }  
  24.   
  25.     ......  
  26.   
  27. }  


由前面对AudioFlinger服务和AudioPolicyService服务的启动流程分析可知,mAudioHwDevs具体指在文件audio_hw_hal.cpp所实现的音频模块中定义的设备。则dev->set_parameters()函数就是adev_set_parameters()函数。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">static int adev_set_parameters(struct audio_hw_device *dev, const char *kvpairs)  
  2. {  
  3.     struct legacy_audio_device *ladev = to_ladev(dev);  
  4.     return "color:#ff0000;">ladev->hwif->setParameters(String8(kvpairs));  
  5. }  

同样根据前面AudioFlinger服务分析可知,ladev->hwif具体指ALSA音频类AudioHardwareALSA的对象。则函数ladev->hwif->setParameters()就是函数AudioHardwareALSA类的setParameters()函数。此函数在头文件hardware/alsa_sound/AudioHardwareALSA.h中定义。


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">class ALSAStreamOps  
  2. {  
  3. public:  
  4.     ALSAStreamOps(AudioHardwareALSA *parent, alsa_handle_t *handle);  
  5.     virtual            ~ALSAStreamOps();  
  6.   
  7.     status_t            set(int *format, uint32_t *channels, uint32_t *rate);  
  8.   
  9.     status_t            "color:#ff0000;">setParameters(const String8& keyValuePairs);  
  10.   
  11.     ......  
  12. }  


此setParameters()函数的实现在提供了ALSA流操作接口的文件hardware/alsa_sound/ALSAStreamOps.cpp中。



[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">"http://www.w3.org/1999/xhtml" style="">status_t ALSAStreamOps::setParameters(const String8& keyValuePairs)  
  2. {  
  3.     AudioParameter param = AudioParameter(keyValuePairs);  
  4.     String8 key = String8(AudioParameter::keyRouting);  
  5.     status_t status = NO_ERROR;  
  6.     int device;  
  7.     LOGV("setParameters() %s", keyValuePairs.string());  
  8.   
  9.     if (param.getInt(key, device) == NO_ERROR) {  
  10.         AutoMutex lock(mLock);  
  11.         "color:#ff0000;">mParent->mALSADevice->route(mHandle, (uint32_t)device, mParent->mode());  
  12.         param.remove(key);  
  13.     }     
  14.   
  15.     if (param.size()) {  
  16.         status = BAD_VALUE;  
  17.     }  
  18.     return status;  
  19. }  

看到route()函数,有点儿面熟吧?!
mParent是在AudioHardwareALSA.h头文件中定义的AudioHardwareALSA类的指针对象,是在创建ALSAStreamOps类实例时初始化的。没有看到什么时候直接创建了ALSAStreamOps类的对象。不过,ALSAStreamOps类同时被AudioStreamOutALSA类和AudioStreamInALSA类继承了,则在创建这两个子类的同时将创建ALSAStreamOps类的对象。 ALSAStreamOps类的子类之一AudioStreamOutALSA类在AudioPolicyManagerBase类被创建时,打开输出音频通道的操作一路调到AudioHardwareALSA类的打开音频通道时被创建。因此,此时mParent将指向AudioHardwareALSA类,不为空。
AudioHardwareALSA *     mParent;
mALSADevice也在创建AudioHardwareALSA类的对象时有了struct alsa_device_t类型的值


[cpp]  view plain copy print ?
  1. "http://www.w3.org/1999/xhtml" style="">"http://www.w3.org/1999/xhtml" style="">struct alsa_device_t {  
  2.     hw_device_t common;  
  3.   
  4.     status_t (*init)(alsa_device_t *, ALSAHandleList &);  
  5.     status_t (*open)(alsa_handle_t *, uint32_t, int);  
  6.     status_t (*close)(alsa_handle_t *);  
  7.     status_t (*route)(alsa_handle_t *, uint32_t, int);  
  8. };  


而这些ALSA函数接口已经指向了具体的函数实现(alsa_default.cpp)。则调到HAL层ALSA音频模块(alsa_default.cpp)中s_route()函数。


[cpp]  view plain copy print ?

你可能感兴趣的:(多媒体)