正确打开alsa录音/播放设备需用硬件id如"hw:0,0"而非硬编码"default"，调用snd_pcm_open时指定snd_pcm_stream_capture或snd_pcm_stream_playback方向；参数配置须通过snd_pcm_hw_params_get_*反查硬件能力，优先选用snd_pcm_format_s16_le、44.1/48khz、2ch等广泛支持值；双工应单次open配snd_pcm_stream_duplex并确保硬件支持；务必处理xrun并调用snd_pcm_recover恢复。
怎么用 snd_pcm_open 正确打开录音/播放设备
嵌入式 Linux 上 ALSA 设备名不能硬写成 "default"，多数板子没配这个 alias。实际得用硬件 ID，比如 "hw:0,0"（声卡 0、设备 0）或 "plughw:1,1"（带自动格式转换的逻辑设备）。用 aplay -l 和 arecord -l 查真实设备编号，注意有些 SoC（如 i.MX6、RK3399）录音和播放是分开的 PCM 设备，比如录音是 hw:0,1，播放是 hw:0,0。
调用 snd_pcm_open 时必须指定方向：SND_PCM_STREAM_CAPTURE 录音，SND_PCM_STREAM_PLAYBACK 播放。别混用，否则返回 -ENODEV 或直接 segfault。
- 设备名写错（如写成
"hw:0"缺少逗号和子设备号）→snd_pcm_open返回-ENOENT - 权限不足（非 root 且没加 audio 组）→ 返回
-EPERM，检查id -Gn是否含audio - 设备被占用（比如 PulseAudio 在跑）→ 返回
-EBUSY，嵌入式环境建议关掉 PulseAudio 或用systemctl --user stop pulseaudio
怎么设置采样率、位深和声道数才不失败
嵌入式音频硬件支持的参数很窄，比如很多 ASoC codec 只支持 16-bit、44.1kHz/48kHz、2ch，强行设 24-bit 或 96kHz 会触发 snd_pcm_hw_params_set_format 返回 -EINVAL。必须用 snd_pcm_hw_params_get_* 系列函数反查硬件能力，而不是假设它支持标准值。
典型流程是：先 snd_pcm_hw_params_any，再逐项 set（格式、通道、速率），每步后调 snd_pcm_hw_params 提交并检查返回值；失败就用 snd_pcm_hw_params_get_rate_min/max 拿范围，缩到硬件真支持的值再重试。
-
snd_pcm_hw_params_set_rate_near比set_rate更安全，它会自动找最接近的可行值 - 格式优先选
SND_PCM_FORMAT_S16_LE（小端 16-bit），几乎所有 ARM 板都原生支持 - 缓冲区大小（
buffer_size）别设太小（8192），导致启动延迟高
怎么避免 snd_pcm_readi / snd_pcm_writei 阻塞或丢数据
默认阻塞模式下，snd_pcm_readi 会等满一周期（period）才返回，但嵌入式系统调度不准，可能卡住。必须用 snd_pcm_nonblock 开启非阻塞，然后轮询 + poll() 监听 snd_pcm_poll_descriptors 返回的 fd 集合，这才是可靠做法。
更关键的是错误恢复：ALSA 容易进 XRUN（缓冲区空/满），此时 snd_pcm_state 返回 SND_PCM_STATE_XRUN，必须调 snd_pcm_recover（传 -EPIPE）重置，否则后续读写全失败。
- 没调
snd_pcm_prepare就直接readi→ 返回-EBADFD - 读到 0 字节 ≠ 结束，可能是 XRUN 后未 recover，要检查
snd_pcm_state - 写数据长度不是帧数整数倍（如双声道 16-bit，传了奇数字节数）→
writei返回负值，按文档要求必须传完整帧
怎么把录音和播放做成同步双工（duplex）
别用两个独立 snd_pcm_t* 打开同一设备做双工——ALSA 内核层不保证它们时钟同步，录音和播放会慢慢漂移。正确做法是只 open 一次，用 SND_PCM_STREAM_DUPLEX，然后共用同一套 hw_params 和 sw_params。
但注意：不是所有硬件支持真正双工。查 /proc/asound/card*/pcm*p/sub*/info 里有没有 duplex: yes。若不支持，强行开 duplex 会失败；此时只能用两个设备（如 hw:0,0 播 + hw:0,1 录），但必须用同一个时钟源（如 I2S MCLK 共享），并在应用层靠时间戳对齐，复杂度陡增。
- 双工模式下，
snd_pcm_hw_params_set_channels必须对录/播通道数一致，否则snd_pcm_hw_params失败 - 用
snd_pcm_sw_params_set_avail_min控制最小可用帧数，避免因处理慢导致 XRUN - 嵌入式内存紧张时，
snd_pcm_mmap_begin比readi/writei更省内存，但需确保平台支持 mmap 访问（ARMv7+ 一般 OK）
ALSA 在嵌入式上最麻烦的从来不是 API 调用，而是硬件能力碎片化和错误恢复路径必须写全——漏掉一次 snd_pcm_recover，程序跑几小时后就静音，debug 日志还看不出明显报错。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
