必须用两个ma_device分别实现播放和录音，各自正确配置format/channels/samplerate等参数并显式设置periodsizeinframes，启动后通过双缓冲和时间戳对齐数据流。
怎么用 ma_device 同时跑播放和录音设备
不能直接用一个 ma_device 同时播放+录音，miniAudio 的设计是单向数据流：要么是 ma_device_type_playback，要么是 ma_device_type_capture。想实现“边录边放”，得开两个设备——一个播，一个采，再自己同步数据。
常见错误是传错 deviceType 或漏掉 captureFormat/playbackFormat 配置，导致 ma_device_init() 返回 MA_INVALID_ARGS。
- 必须分别初始化两个
ma_device：一个设deviceType = ma_device_type_playback，另一个设deviceType = ma_device_type_capture - 两个设备的
sampleRate、channels、format最好一致，否则你得自己重采样，容易引入延迟或爆音 - 用
ma_device_start()分别启动，别只启一个 - 回调函数里别直接 memcpy 大块音频——miniAudio 回调是实时线程，耗时操作会丢帧；先 memcpy 到双缓冲区，再由主线程处理
ma_device_config 里哪些字段不填会崩
最常踩的坑是只填了 playback 相关字段，却忘了录音设备也得配 capture 字段，或者反过来。miniAudio 不会帮你补默认值，缺字段就返回 MA_INVALID_ARGS 或静默失败。
- 播设备必填：
playback.format、playback.channels、playback.sampleRate、playback.pBuffer（如果用回调） - 录设备必填：
capture.format、capture.channels、capture.sampleRate、capture.pBuffer -
periodSizeInFrames建议显式设（比如 512），不设可能用平台默认值，Windows 上常偏大，导致高延迟 -
dataCallback和pUserData必须一起设，漏掉pUserData会导致回调里访问野指针
Windows 下录音无声或只有杂音的典型原因
不是代码写错了，大概率是 Windows 音频策略或权限问题。miniAudio 本身不处理系统级音频路由，它只跟 WASAPI/DSound 打交道。
- 检查系统麦克风是否被禁用或静音（不只是应用内，是系统设置里的“麦克风访问权限”）
- 确认用的是
ma_backend_wasapi（Windows 默认），而不是ma_backend_directsound——后者在 Win10+ 上已废弃，录音常失败 - 如果用立体声录音但硬件只支持单声道，
ma_device_init()可能成功但实际录不到有效数据；建议先用ma_context_enumerate_devices()查设备真实支持的格式 - 避免在回调里调
printf或std::cout——Windows 实时音频线程对 I/O 敏感，容易卡死或崩溃
怎么安全地停止并释放两个设备
顺序错了会 crash：必须先 ma_device_stop()，再 ma_device_uninit()，而且两个设备都得做。没停就 uninit，WASAPI 后端会报 MA_DEVICE_NOT_INITIALIZED 或访问已释放内存。
- 停止顺序无所谓，但每个设备都要独立 stop + uninit
- 回调函数里别调
ma_device_stop()——这是阻塞操作，会死锁；应该用原子标志位通知主线程去停 - 如果用了自定义内存分配器（
pAllocationCallbacks），确保uninit时传入的回调和init时一致，否则 free 会错堆 - 设备句柄（
ma_device*）在uninit后立刻失效，别存指针留到之后用
真正麻烦的从来不是开设备，而是多设备间的时间对齐和缓冲区管理——miniAudio 不提供时钟同步 API，得靠你自己用 ma_device_get_position() + 时间戳做粗略对齐，这点很容易被忽略。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
