音量调节本质是对PCM采样值进行线性缩放，需在解码后的整数PCM数据上操作，使用int32_t中间计算并clamp截断，避免浮点转换误差和溢出。
音量调节本质是线性缩放采样值
音量调节在数字音频中不是“变大声音”，而是对 PCM 采样点做统一的乘法缩放。比如 16 位有符号整数（int16_t）的样本范围是 [-32768, 32767]，乘以 0.5 就是整体衰减 6dB；乘以 1.2 则是轻微提升（但需防溢出）。关键在于：必须在解码后的 PCM 数据上操作，不能对 MP3/WAV 容器或压缩数据直接运算。
用 std::vector<int16_t></int16_t> 做就地缩放最安全
假设你已用 miniaudio、libsndfile 或自己解析得到原始 PCM 数据，存在 std::vector<int16_t></int16_t> 中。此时直接遍历修改即可，无需额外缓冲：
float gain = 0.7f; // -3dB
for (auto& s : samples) {
int32_t scaled = static_cast<int32_t>(s) * gain;
s = static_cast<int16_t>(std::clamp(scaled, -32768LL, 32767LL));
}
注意三点：
-
int16_t直接乘 float 易溢出，务必先升到int32_t再缩放 - 必须用
std::clamp（C++17）或手动截断，否则溢出会绕回（如 32768 → -32768） - 增益值建议控制在 0.0 ~ 1.5 范围内，超过 1.0 时失真风险陡增
避免用浮点数组存 PCM 导致精度损失
有些代码会先把 int16_t 转成 float 数组（归一化到 [-1.0, 1.0]），调节后再转回——这看似“更精确”，实则引入两轮转换误差，且增加内存占用和 cache miss。除非你在做复杂 DSP（如均衡、混响），否则纯音量调节完全没必要脱离整数域。
立即学习“C++免费学习笔记（深入）”；
常见错误现象：audio glitches every few seconds，往往就是类型转换未对齐或截断逻辑缺失导致的静音/爆音。
WebAssembly 或嵌入式环境要禁用 std::clamp
在无 C++17 支持的环境（如老版本 Emscripten、裸机 ARM），std::clamp 不可用。改用三目运算：
s = static_cast<int16_t>(scaled > 32767 ? 32767 : (scaled < -32768 ? -32768 : scaled));
另外，若目标平台不支持 32 位整数（极少见），需改用饱和加法指令或查表法——但绝大多数现代 MCU 和 WASM 都支持 int32_t。
真正容易被忽略的是：音量调节必须在重采样之后、播放之前完成。如果在 resample 前调节，会导致频率响应畸变；如果在驱动层之后调节（比如 ALSA 的 softvol 插件），你就失去了对信号流的控制权。
