Windows用ISimpleAudioVolume控制本进程音量与静音，Linux用pactl命令行，macOS需通过AudioObject发送系统通知；三者均依赖权限、上下文及后端状态。
Windows平台用ISimpleAudioVolume调节音量和静音
在Windows上，最稳定且支持现代应用（包括UWP和桌面程序）的方式是通过Windows Core Audio API的ISimpleAudioVolume接口。它能精确控制当前进程的音频会话音量和静音状态，不依赖全局系统音量，避免干扰其他程序。
常见错误是直接调用IAudioEndpointVolume——它操作的是默认播放设备的硬件音量，权限要求高、易被系统策略拦截，且对多应用混音场景不友好。
- 必须先获取
IAudioSessionControl，再通过QueryInterface拿到ISimpleAudioVolume -
SetVolume()接受0.0到1.0之间的浮点值（不是百分比），0.5表示-6dB；传入负数或>1.0会被截断但不报错 -
SetMute(BOOL)设为TRUE即静音，FALSE恢复；注意该状态仅作用于当前音频会话，不影响系统托盘图标显示 - 若程序未声明
app.manifest中启用uiAccess="true"（仅限签名的高权限应用），无法控制其他进程的会话
Linux下用pactl命令行间接控制（无原生C++ API）
Linux没有统一的C++系统级音量API，主流方案是调用pactl命令行工具并解析其输出。PulseAudio或PipeWire环境均可工作，但需确保用户有对应权限（通常属于audio组）。
直接链接libpulse.so自行调用PulseAudio C API理论上可行，但回调模型复杂、线程安全难保障，实际项目中90%以上选择std::system()或poppen()执行pactl更可靠。
立即学习“C++免费学习笔记（深入）”；
- 设置主音量：
pactl set-sink-volume @DEFAULT_SINK@ 50%（支持+5%、-10%等相对调整） - 切换静音：
pactl set-sink-mute @DEFAULT_SINK@ toggle，返回码0表示成功，1表示失败（如服务未运行） - 获取当前状态需解析
pactl get-sink-volume @DEFAULT_SINK@输出，匹配Mute:和Volume:行 - 注意Shell注入风险：音量值若来自用户输入，必须过滤空格、分号、$()等字符，否则
std::system("pactl ... " + user_input)可能执行任意命令
macOS需用AudioHardwareService和AudioObject API
macOS不允许第三方应用直接修改系统音量，必须通过Core Audio的AudioObject机制监听并触发系统级调节。本质是向系统发送“用户按了音量键”的模拟事件，由coreaudiod进程统一处理。
不能用AudioHardwareServiceSetPropertyData硬写音量值——从macOS 10.15起该调用被沙箱禁止，即使Disable Library Validation也无效。
- 正确做法是调用
AudioHardwareServiceSendNotification配合kAudioHardwareServiceProperty_PlaybackVolume，但该API仅通知系统，不保证立即生效 - 静音控制同理，使用
kAudioHardwareServiceProperty_Mute，参数类型为UInt32（0=非静音，1=静音） - 需要链接
-framework CoreAudio -framework AudioToolbox，且工程配置中关闭bitcode（Xcode默认开启） - 沙盒应用需在entitlements中声明
com.apple.audio.audio-device权限，否则调用直接失败返回kAudioHardwareUnknownPropertyError
跨平台封装时最容易忽略的权限与上下文问题
音量控制不是纯计算逻辑，它强依赖运行时环境权限、音频会话生命周期和系统策略。很多开发者把代码写对了却调用失败，根本原因不在API用法，而在上下文缺失。
- Windows：控制其他进程音量需管理员权限，且目标进程必须已创建音频会话（刚启动的应用可能还没注册）
- Linux：
pactl命令在SSH会话中默认找不到PULSE_SERVER，需显式设置环境变量或改用dbus-send调用PulseAudio D-Bus接口 - macOS：音量变更通知可能被系统延迟处理，连续快速调用
setVolume可能被合并或丢弃，建议加50ms间隔 - 所有平台都需检查音频后端是否就绪——例如Linux PulseAudio崩溃时
pactl返回非零码，Windows上CoInitialize未调用会导致COM接口创建失败
