Java Sound API 调节音量须通过 FloatControl.Type.MASTER_GAIN 实现，且必须先检测线路是否支持该控制，否则会抛异常或返回 null；MASTER_GAIN 单位为 dB，典型范围 -80.0 至 6.0，设置时需约束边界并避免直接线性映射百分比。
Java Sound API 本身不提供直接的 setVolume() 方法，音量调节必须通过操作音频线路（Line）的 FloatControl 实现，且仅对支持 FloatControl.Type.MASTER_GAIN 的线路有效——不是所有音频输出设备都暴露该控制项。
确认目标音频线路是否支持 MASTER_GAIN 控制
很多初学者调用 getControl(FloatControl.Type.MASTER_GAIN) 报 IllegalArgumentException 或返回 null，根本原因是底层混音器/线路未实现该控制类型。必须先检测再操作：
AudioFormat format = new AudioFormat(AudioFormat.Encoding.PCM_SIGNED,
44100, 16, 2, 4, 44100, false);
DataLine.Info info = new DataLine.Info(SourceDataLine.class, format);
SourceDataLine line = (SourceDataLine) AudioSystem.getLine(info);
line.open(format);
// 关键：检查是否支持 MASTER_GAIN
if (line.isControlSupported(FloatControl.Type.MASTER_GAIN)) {
FloatControl volumeControl = (FloatControl) line.getControl(FloatControl.Type.MASTER_GAIN);
System.out.println("Min: " + volumeControl.getMinimum() +
", Max: " + volumeControl.getMaximum() +
", Current: " + volumeControl.getValue());
} else {
System.out.println("MASTER_GAIN not supported on this line");
}
- 常见不支持场景：某些 USB 声卡、虚拟音频设备（如 VB-Cable）、macOS 上部分输出设备
-
MASTER_GAIN单位是分贝（dB），典型范围约为 -80.0 dB（静音）到 6.0 dB（最大增益） - 若不支持，可考虑在音频数据层面做软件增益（需手动缩放 PCM 样本值），但会损失精度且需注意溢出
安全设置音量值：避免越界和静音陷阱
直接赋值 volumeControl.setValue(-20.0f) 很危险——超出范围会抛 IllegalArgumentException；设为 -80.0f 虽然“静音”，但部分驱动实际无法完全归零，残留底噪。应始终约束并四舍五入：
FloatControl volumeControl = (FloatControl) line.getControl(FloatControl.Type.MASTER_GAIN);
float targetDb = Math.max(volumeControl.getMinimum(),
Math.min(volumeControl.getMaximum(), -15.0f));
volumeControl.setValue(targetDb);- 不要用百分比直接映射 dB 值（例如“50%音量”≠“-30dB”），dB 是对数尺度，线性映射会导致低音量段调节过敏感
- 若需 UI 滑块（0–100），建议用非线性映射：比如
db = min + (max - min) * Math.pow(sliderValue / 100.0, 2.0) - 调用
setValue()时线路必须已start()，否则部分实现可能忽略或延迟生效
动态调节时的线程与生命周期注意事项
音量控制是实时生效的，但必须确保在同一线程操作（尤其当 SourceDataLine 在后台线程运行时）。更关键的是：线路关闭后，控制对象失效，再次调用会抛 IllegalStateException。
立即学习“Java免费学习笔记（深入）”；
- 不要缓存
FloatControl引用并在线路关闭后继续使用 - 若需频繁调节（如响应滑块拖动），避免高频调用
setValue()（每秒几十次无意义，人耳分辨不出），加简单防抖（如 50ms 内只取最后一次值） - 使用
Clip播放短音频时，Clip不支持MASTER_GAIN（它只暴露FramePosition和MicrosecondPosition控制），必须改用SourceDataLine或自行混音
最易被忽略的一点：Windows 上默认播放设备（如“扬声器”）通常支持 MASTER_GAIN，但若用户切换到“立体声混音”或“通讯设备”，控制可能突然消失——务必在每次线路打开后重新探测，不能假设一次检测永久有效。
