1- [三方开源软件alsa-lib](#三方开源软件alsa-lib) 2 - [1. Alsa-lib简介](#1-alsa-lib简介) 3 - [2. 引入背景简述](#2-引入背景简述) 4 - [3. 使用场景](#3-使用场景) 5 - [4. 为OpenHarmony带来的价值](#4-为openharmony带来的价值) 6 - [5. 如何使用](#5-如何使用) 7 - [5.1 内核编译开关配置](#51-内核编译开关配置) 8 - [5.2 产品化编译开关配置](#52-产品化编译开关配置) 9 - [5.3 alsa-lib组件编译依赖添加](#53-alsa-lib组件编译依赖添加) 10## 三方开源软件alsa-lib 11### 1. Alsa-lib简介 12ALSA-lib是和Linux内核虚拟设备ALSA进行接口的库，虽然Linux下ALSA给用户空间提供了系统调用，但alsa-lib对系统调用进行进一步封装，并实现了很多插件，例如多音频源进行混音播放时，调用的就是dmix插件。ALSA-lib是ALSA框架应用库(必需基础库)。 13 14源代码最新参考资料可以访问：[alsa-lib官网主页](http://www.alsa-project.org/alsa-doc/alsa-lib/)。 15您也可以通过[ALSA官网主页](http://www.alsa-project.org)了解更多关于ALSA项目的信息。 16 17### 2. 引入背景简述 18Openharmony南向生态发展过程中，已经支持过ALSA的OEM产商在接入OpenHarmony过程中存在使用内核ALSA框架的诉求。鉴于此OpenHarmony Audio为支持南向生态伙伴快速接入鸿蒙、快速实现产品化而提供的“ALSA兼容方案”，本方案采用插件化的适配器模式通过alsa-lib实现ALSA的兼容。 19 20### 3. 使用场景 21本方案仅供OEM产商中已支持ALSA框架的设备在移植OpenHarmony系统过程中作为备选方案使用，建议优先选择ADM(Audio Driver Model, HDF 音频驱动模型)。 22本仓接口能力的直接调用对象为驱动子系统的Audio模块。 23 24### 4. 为OpenHarmony带来的价值 251. 满足OEM生态伙伴中已支持的ALSA的产品快速接入OpenHarmony诉求。 262. 提供产品化过程中ADM(Audio Driver Model, HDF 音频驱动模型)暂不具备的能力。 27 28### 5. 如何使用 29ADM与ALSA在一款特定产品上的使用方式为二选一，考虑到设备内存，不建议两者同时存在。 30使用过程中需要完成内核编译选项的配置、产品化编译开关的配置，如需产商需要自己实现设备抽象层(DAL)，则需要配置对的编译依赖。 31 32#### 5.1 内核编译开关配置 33 34需要在各自产品的Linux kernel配置文件中打开对应开关，路径如下：其中${product_name}表示您的产品名称 35 36kernel/linux/config/linux-5.10/arch/arm64/configs/${product_name}_standard_defconfig 37 38以rk3568_standard_defconfig为例配置如下： 39 40```sh 41CONFIG_SOUND=y 42CONFIG_SND=y 43 44# CONFIG_DRIVERS_HDF_AUDIO is not set 45# CONFIG_DRIVERS_HDF_AUDIO_RK3568 is not set 46``` 47#### 5.2 产品化编译开关配置 48 49需要在各自产品配置文件中打开对应开关，路径如下：其中${product_company}表示您的企业名称，${product_name}表示您的产品名称 50```bash 51 52/vendor/${product_company}/${product_name}/config.json 53``` 54开关如下：在drivers_peripheral_audio部件节点下，找到特性宏drivers_peripheral_audio_alsa_lib，开启为true，关闭为false，默认为false. 55```json 56drivers_peripheral_audio_alsa_lib = true 57``` 58 59#### 5.3 alsa-lib组件编译依赖添加 60如需要重新实现Audio DAL，则需要添加alsa-lib组件的编译依赖，可以采用以下两种方法进行添加。 61**方法一（可选）：** 62在您的 bundle.json 文件 添加 63```json 64"deps": { 65 "third_part": [ 66 "alsa-lib" 67 ] 68} 69``` 70**方法二（可选）：** 71在您的BUILD.gn需要的地方添加依赖 72```json 73deps += [ "//third_party/alsa-lib:libasound" ] 74``` 75