应使用iaudioendpointvolume获取windows全局音量，用kaudioobjectsystemobject查macos系统音量，linux优先选libpulse；各平台需独立同步音量值与静音状态，二者不可合并处理。
Windows 上用 ISimpleAudioVolume 读不到真实系统音量？
不是读不到，是它只管当前进程的音量（比如你的程序被调成 50%，不代表系统是 50%）。真要拿全局音量，得走 IAudioEndpointVolume —— 它对应的是默认播放设备的主音量滑块。
常见错误是没正确获取默认渲染端点（eRender 方向）或没初始化 COM（必须在主线程调 CoInitializeEx(NULL, COINIT_APARTMENTTHREADED)）。
- 先用
IMMDeviceEnumerator::GetDefaultAudioEndpoint(eRender, eConsole, &pEndpoint)拿设备 - 再用
pEndpoint->Activate(__uuidof(IAudioEndpointVolume), ...)激活接口 - 调
IAudioEndpointVolume::GetMasterVolumeLevelScalar()得到 0.0–1.0 归一化值 - 注意：这个值不等于 Windows 设置里显示的百分比（后者是 UI 映射，底层是线性幅度值）
macOS 用 Core Audio 获取音量为什么总返回 0？
因为默认用错了音频对象 ID。系统音量不是查某个输入/输出设备，而是查「默认输出设备」的 kAudioHardwareServiceDeviceProperty_Volume 属性，且必须用 kAudioObjectSystemObject（ID = 0x0）作为目标对象。
容易漏掉两步：一是没调 AudioObjectGetPropertyDataSize 预查大小，二是传了错误的 AudioObjectID（比如用了某个具体设备 ID 而非系统对象）。
立即学习“C++免费学习笔记（深入）”；
- 查音量前先确认是否静音：
kAudioHardwareServiceDeviceProperty_Mute - 音量值类型是
Float32，范围 0.0（静音）到 1.0（最大），但 macOS 系统设置 UI 实际映射是非线性的 - 不需要 Audio Unit 或 Audio Queue，纯属性查询即可，轻量且无权限弹窗
Linux 下没有统一 API，libpulse 和 ALSA 怎么选？
优先用 libpulse：它兼容 PulseAudio 和 PipeWire（现代主流发行版默认），接口稳定；ALSA 直接操作硬件混音器（如 hw:0）容易受桌面环境接管干扰，且无法反映 GNOME/KDE 的音量 UI 状态。
典型坑是连接未就绪就发请求，或没处理异步回调导致阻塞。PulseAudio 的音量单位是“刻度值”（pa_volume_t），需除以 PA_VOLUME_NORM 转为 0.0–1.0。
- 用
pa_context_connect()连接上下文，等PA_CONTEXT_READY后再查 - 调
pa_context_get_sink_info_by_name()查默认 sink（通常是@DEFAULT_SINK@） -
sink_info.volume.value_flat是当前主音量，不是各通道分别值 - 别硬编码 sink 名，用
pa_context_get_server_info()拿default_sink_name
跨平台封装时最容易忽略的静音状态同步
音量数值和静音开关是两个独立属性。Windows/macOS/Linux 都提供单独的静音查询接口，但很多实现只读音量、忽略 mute，结果 UI 显示 80% 却实际静音，用户困惑。
更隐蔽的问题是：某些系统（如 macOS）在静音状态下，音量值仍可被修改，解除静音后会立即生效——这意味着你不能只缓存一个“音量”变量，必须同时维护 is_muted 和 volume_level 两个状态。
- Windows：查
IAudioEndpointVolume::GetMute() - macOS：查
kAudioHardwareServiceDeviceProperty_Mute - Linux（PulseAudio）：
sink_info.mute == 1 - 所有平台都建议把 mute + volume 封装成原子结构体，避免中间态错乱
静音不是音量的特例，它是并行控制维度。漏掉它，跨平台音量同步就只是半截逻辑。
