4. ALSA 库接口（alsa-lib）入门：安装与编译、主要头文件、核心数据结构

ALSA 库（alsa-lib）是用户空间应用程序访问 ALSA 内核驱动的标准接口。它封装了底层的 ioctl 系统调用，提供了面向对象风格的 API，用于 PCM 播放/录音、混音器控制、设备枚举和配置管理。本章将介绍 alsa-lib 的安装方法、核心头文件以及最重要的两个数据结构：snd_pcm_t 和 snd_mixer_t。

4.1 安装与编译

4.1.1 安装 alsa-lib 开发包

在大多数 Linux 发行版中，alsa-lib 分为运行时库和开发包两部分。编译应用程序时需要安装开发包。

4.1.2 编译链接示例

使用 pkg-config 可以自动获取编译器和链接器参数，避免手动指定路径。

# 编译单个源文件
gcc -o my_alsa_app my_alsa_app.c $(pkg-config --cflags --libs alsa)

# 使用 Makefile 的典型写法
CFLAGS += $(shell pkg-config --cflags alsa)
LDFLAGS += $(shell pkg-config --libs alsa)

my_alsa_app: my_alsa_app.o
    $(CC) -o $@ $^ $(LDFLAGS)

4.2 主要头文件：alsa/asoundlib.h

ALSA 库将所有公共 API 集中在一个头文件中：alsa/asoundlib.h。这个头文件会进一步包含各个子模块的头文件，开发者只需包含这一个文件即可。

4.3 核心数据结构：snd_pcm_t

snd_pcm_t 是 ALSA PCM 接口的核心句柄，代表一个 PCM 设备实例。所有 PCM 操作（打开、设置参数、读写数据、关闭）都围绕这个句柄进行。

4.3.1 生命周期与典型操作流程

1. 打开设备： snd_pcm_open() 创建 snd_pcm_t 句柄。
2. 设置硬件参数： snd_pcm_hw_params_*() 设置采样率、格式、通道数等。
3. 设置软件参数： snd_pcm_sw_params_*() 设置启动阈值、中断触发条件等。
4. 准备设备： snd_pcm_prepare() 使设备进入就绪状态。
5. 读写数据： snd_pcm_writei() / snd_pcm_readi() 进行音频数据传输。
6. 关闭设备： snd_pcm_close() 释放句柄和资源。

4.3.2 常用 PCM 操作函数

4.4 核心数据结构：snd_mixer_t

snd_mixer_t 是 ALSA 混音器接口的核心句柄，代表一个混音器设备实例。通过它，应用程序可以枚举、查询和控制音频混音器中的各个元素（如音量滑块、开关、选择器）。

4.4.1 混音器层次结构

ALSA 混音器采用三层结构组织：

• 混音器句柄（snd_mixer_t）： 代表整个混音器设备。
• 混音器元素（snd_mixer_elem_t）： 代表一个控制单元，如 "Master" 音量、"PCM" 音量、"Mic Boost" 开关等。
• 混音器元素 ID（snd_mixer_selem_id_t）： 用于标识和查找特定元素，包含名称和索引。

4.4.2 混音器操作流程

1. 打开混音器： snd_mixer_open() 创建 snd_mixer_t 句柄。
2. 附加设备： snd_mixer_attach() 将混音器句柄绑定到具体的声卡设备（如 "hw:0"）。
3. 注册元素： snd_mixer_selem_register() 注册混音器元素类。
4. 加载元素： snd_mixer_load() 从内核加载所有混音器元素。
5. 查找元素： snd_mixer_find_selem() 根据名称和索引查找特定元素。
6. 控制元素： 使用 snd_mixer_selem_set_*() 系列函数设置音量、开关等。
7. 关闭混音器： snd_mixer_close() 释放所有资源。

4.4.3 常用混音器操作函数

4.5 核心数据结构关系图

下图展示了 snd_pcm_t 和 snd_mixer_t 在用户空间应用程序中的位置及其与内核驱动的关系。

4.6 代码示例：打开 PCM 设备并设置参数

以下代码演示了如何使用 snd_pcm_t 打开一个播放设备并设置基本参数。

#include <stdio.h>
#include <stdlib.h>
#include <alsa/asoundlib.h>

int main() {
    snd_pcm_t *handle;
    snd_pcm_hw_params_t *params;
    int rc;
    unsigned int rate = 44100;
    int dir;

    /* 1. 打开 PCM 设备 */
    rc = snd_pcm_open(&handle, "default", SND_PCM_STREAM_PLAYBACK, 0);
    if (rc < 0) {
        fprintf(stderr, "无法打开 PCM 设备: %s\n", snd_strerror(rc));
        return 1;
    }

    /* 2. 分配硬件参数对象 */
    snd_pcm_hw_params_alloca(&params);

    /* 3. 初始化硬件参数 */
    snd_pcm_hw_params_any(handle, params);

    /* 4. 设置参数 */
    snd_pcm_hw_params_set_access(handle, params, SND_PCM_ACCESS_RW_INTERLEAVED);
    snd_pcm_hw_params_set_format(handle, params, SND_PCM_FORMAT_S16_LE);
    snd_pcm_hw_params_set_channels(handle, params, 2);
    snd_pcm_hw_params_set_rate_near(handle, params, &rate, &dir);

    /* 5. 将参数写入驱动 */
    rc = snd_pcm_hw_params(handle, params);
    if (rc < 0) {
        fprintf(stderr, "无法设置硬件参数: %s\n", snd_strerror(rc));
        snd_pcm_close(handle);
        return 1;
    }

    printf("PCM 设备已打开，采样率: %u Hz\n", rate);

    /* 6. 准备设备 */
    snd_pcm_prepare(handle);

    /* ... 此处可进行音频数据读写 ... */

    /* 7. 关闭设备 */
    snd_pcm_close(handle);
    return 0;
}

4.7 本章小结

• 安装： 使用发行版包管理器安装 libasound2-dev 或 alsa-lib-devel，通过 pkg-config 获取编译参数。
• 头文件： 只需包含 alsa/asoundlib.h，它自动引入所有子模块。
• snd_pcm_t： PCM 设备句柄，用于音频数据的播放和录音，操作流程为 打开 → 设置参数 → 准备 → 读写 → 关闭。
• snd_mixer_t： 混音器设备句柄，用于控制音量、开关等，操作流程为 打开 → 附加 → 注册 → 加载 → 查找元素 → 控制 → 关闭。
• 不透明指针： 两个核心句柄都是不透明类型，应用程序不能直接访问内部结构，必须通过 API 函数操作。