一、ALSA lib库介绍
使用 ALSA 的 lib 库中的 snd_pcm_xxx 等标准接口函数，操作 /dev/snd/pcmC0D0c或pcmC0D0p 等录放音设备节点，相当于在 OSS 框架下通过 ioctl 设置不同参数去操作 /dev/dsp 设备
ALSA功能丰富，可以设置音频参数，DMA buffer 大小、分块数量，buffer 阀值等
二、ALSA lib库接口
1.1 snd_pcm_open
函数原型：snd_pcm_open(&handle, pcm_name, stream, open_mode);
函数功能：打开pcm设备
参数含义：
&handle：static snd_pcm_t *handle 结构体指针
pcm_name：打开的pcm设备节点，可以是“default” ,也可以是“hw:0,0”
stream：对应放音与录音操作，SND_PCM_STREAM_PLAYBACK，SND_PCM_STREAM_CAPTURE
open_mode：一些相关功能设置，比如：是否阻塞，是否重采样，是否软件调音量等
1.2 snd_pcm_info
函数原型：snd_pcm_info(handle, info)；
函数功能：用来获取录放音、声卡与设备等相关信息，不是必须的接口
参数含义：
handle：static snd_pcm_t *handle 结构体指针
info：设备信息
1.3 snd_pcm_writei
函数原型：snd_pcm_writei(snd_pcm_t *pcm, const void *buffer, snd_pcm_uframes_t size)；
函数功能：播放交错格式的音频数据
参数含义：
pcm:pcm设备
buffer:数据地址
size：数据大小
1.4 snd_pcm_readi
函数原型：snd_pcm_readi(snd_pcm_t *pcm, void *buffer, snd_pcm_uframes_t size)；
函数功能：录制交错格式的音频数据
参数含义：
pcm:pcm设备
buffer:数据地址
size：数据大小
1.5 snd_pcm_drain
函数原型：snd_pcm_drain(handle);
函数功能：等待buffer中的数据全部播放完成
参数含义：
handle:句柄
1.6 snd_pcm_drop
函数原型：snd_pcm_drop(handle);
函数功能：不等待buffer数据播放完成，马上停止
参数含义：
handle:句柄
1.7 snd_pcm_hw_params_set_rate_resample
函数原型：snd_pcm_hw_params_set_rate_resample(handle, params, soft_resample);
函数功能：设置采样率
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.8 snd_pcm_close
函数原型：snd_pcm_close(handle)；
函数功能：关闭pcm handle
参数含义：
handle：static snd_pcm_t *handle 结构体指针
1.9 snd_pcm_hw_params_set_channels
函数原型：snd_pcm_hw_params_set_channels(handle, params, hwparams.channels);
函数功能：设置声道数
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.10 snd_pcm_hw_params_set_rate_near
函数原型：snd_pcm_hw_params_set_rate_near(handle, params, &hwparams.rate, 0);
函数功能：设置采样率，之所以是rate_near，是因为上层设置的采样率&hwparams.rate，底层很可能不支持，因此，会返回上层一个底层支持的相近的采样率
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.11 snd_pcm_hw_params_get_buffer_time_max
函数原型：snd_pcm_hw_params_get_buffer_time_max(params, &buffer_time, 0);
函数功能：获取底层支持的最大buffer大小，换算为时间
参数含义：
params：参数
1.12 snd_pcm_hw_params_set_period_time_near
函数原型：snd_pcm_hw_params_set_period_time_near(handle, params, &period_time, 0);
函数功能：设置底层period区间大小，以时间为单位，之所以为time_near，是因为上层设置的大小很可能底层不支持，底层会返回相近的&period_time
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.13 snd_pcm_hw_params_set_period_size_near
函数原型：snd_pcm_hw_params_set_period_size_near(handle, params, &period_frames, 0);
函数功能：设置底层period区间大小，以字节为单位，size_near，原因类似。该接口与set_period_time_near接口，都是设置period大小，只是单位不同，二选一即可
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.14 snd_pcm_hw_params_set_buffer_time_near
函数原型：snd_pcm_hw_params_set_buffer_time_near(handle, params, &buffer_time, 0);
函数功能：设置底层buffer区间大小，以时间为单位。与上面接口类似。在底层，buffer是一个大DMA空间，而period是将buffer平均分成的几个小区间
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.15 snd_pcm_hw_params_set_buffer_size_near
函数原型：snd_pcm_hw_params_set_buffer_size_near(handle, params, &buffer_frames);
函数功能：与上类似，上面设置完成后，都需要调用下面两个函数，获取最终设置的period与buffer大小
1、snd_pcm_hw_params_get_period_size(params, &chunk_size, 0);
2、snd_pcm_hw_params_get_buffer_size(params, &buffer_size);
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.16 snd_pcm_hw_params_set_format
函数原型：snd_pcm_hw_params_set_format(handle, params, hwparams.format);
函数功能：设置采样位宽格式
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.17 snd_pcm_hw_params_can_pause
函数原型：snd_pcm_hw_params_can_pause(params);
函数功能：查询底层是否支持暂停
参数含义：
params：参数
1.18 snd_pcm_hw_params
函数原型： snd_pcm_hw_params(handle, params);
函数功能：将上面设置的硬件配置参数，加载，并且会自动调用snd_pcm_prepare（ ）将stream状态置为SND_PCM_STATE_PREPARED
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.19 snd_pcm_sw_params_alloca
函数原型：snd_pcm_sw_params_alloca(&swparams);
函数功能：申请一段空间，存放软件配置参数
参数含义：
swparams:软件配置参数
1.20 snd_pcm_sw_params_current
函数原型：snd_pcm_sw_params_current(handle, swparams);
函数功能：获取当前的软件参数配置
参数含义：
handle：static snd_pcm_t *handle 结构体指针
swparams:软件配置参数
1.21 snd_pcm_sw_params_set_avail_min
函数原型：snd_pcm_sw_params_set_avail_min(handle, swparams, n);
函数功能：阻塞模式下，设置已缓存一定buffer大小后开始下一次取数据
参数含义：
handle：static snd_pcm_t *handle 结构体指针
swparams:软件配置参数
n:块数量
1.22 snd_pcm_sw_params_set_start_threshold
函数原型：snd_pcm_sw_params_set_start_threshold(handle, swparams, start_threshold);
函数功能：设置开始的阀值，可以起到预缓冲的效果。对于放音，当上层调用snd_pcm_writei超过阀值时，才会启动播放
参数含义：
handle：static snd_pcm_t *handle 结构体指针
swparams:软件配置参数
start_threshold:阈值
1.23 snd_pcm_sw_params_set_stop_threshold
函数原型：snd_pcm_sw_params_set_stop_threshold(handle, swparams, stop_threshold);
函数功能：设置停止的阀值，避免硬件上的underrun或overrun出现
参数含义：
handle：static snd_pcm_t *handle 结构体指针
swparams:软件配置参数
start_threshold:阈值
1.24 snd_pcm_sw_params
函数原型：snd_pcm_sw_params(handle, swparams)；
函数功能：将上面的软件参数，加载到底层
参数含义：
swparams:软件配置参数
1.25 snd_pcm_hw_params_any
函数原型：snd_pcm_hw_params_any(handle, params);
函数功能：初始化pcm属性
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.26 snd_pcm_hw_params_set_access
函数原型：snd_pcm_hw_params_set_access(handle, params,SND_PCM_ACCESS_RW_INTERLEAVED);
函数功能：设置为交错方式
参数含义：
handle：static snd_pcm_t *handle 结构体指针
params：参数
1.27 snd_pcm_format_set_silence
函数原型：snd_pcm_format_set_silence(snd_pcm_format_t format, void *data, unsigned int samples)；
函数功能：用于将某个buffer中的数据，转换为静音，也就是0
参数含义：
format:格式
data:数据地址
samples：数据大小
1.28 snd_pcm_nonblock
函数原型：snd_pcm_nonblock(handle, 0);
函数功能：打开或关闭阻塞模式。0，为阻塞模式，1，为非阻塞模式
参数含义：
handle:句柄
1.29 snd_pcm_nonblock
函数原型：snd_pcm_nonblock(handle, 1);
函数功能：如果需要非阻塞方式，则将第二个参数，设置为1。snd_pcm_open后，默认为阻塞方式，因此，该接口可以不用调用
参数含义：文章来源：https://www.toymoban.com/news/detail-575456.html
handle：static snd_pcm_t *handle 结构体指针
1.30 snd_pcm_hw_params_alloca
函数原型：`snd_pcm_hw_params_alloca(¶ms);
函数功能：申请一段snd_pcm_hw_params_t *params;结构体空间。使用该结构体，来配置底层ALSA的相关硬件参数，比如：声道，采样率，位宽，buffer大小等
参数含义：文章来源地址https://www.toymoban.com/news/detail-575456.html
params:参数
到了这里，关于六、ALSA lib库接口的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！
