Java用AudioFormat和SourceDataLine可轻量合成播放正弦波提示音，需手动构造小端序16位PCM字节流、控制幅度±32767、帧对齐写入，避免使用不可控的Toolkit.beep()。
Java 用 AudioFormat 和 SourceDataLine 播放正弦波提示音
Java 标准库不提供“播放 beep”的高级封装，但能用 javax.sound.sampled 直接合成并播放正弦波——这是最轻量、无需外部依赖的方案。关键不是调用某个现成函数，而是手动构造 PCM 音频字节流，再喂给音频输出设备。
常见错误是直接写 float 数组或误用 Clip（它要求完整音频数据加载进内存，不适合实时生成）；正确路径是用 SourceDataLine 流式写入字节。
-
AudioFormat必须设为 PCM_SIGNED，采样率常用 44100 或 8000，位深 16，单声道 - 正弦波幅度必须控制在 ±32767（16-bit signed short 范围），否则削波失真
- 相位增量 =
2 * Math.PI * frequency / sampleRate，每次循环累加，避免浮点误差累积 - 务必在写入前调用
line.start()，且写入字节长度必须是帧对齐的（16-bit 单声道：每帧 2 字节）
import javax.sound.sampled.*; import java.util.Arrays;public class BeepPlayer { public static void playTone(int frequency, int durationMs) throws Exception { int sampleRate = 44100; AudioFormat format = new AudioFormat(AudioFormat.Encoding.PCM_SIGNED, sampleRate, 16, 1, 2, sampleRate, false); SourceDataLine line = AudioSystem.getSourceDataLine(format); line.open(format); line.start();
byte[] buffer = new byte[4096]; double phase = 0.0; double phaseIncrement = 2.0 * Math.PI * frequency / sampleRate; int totalSamples = (int) (sampleRate * durationMs / 1000.0); for (int i = 0; i < totalSamples; ) { int offset = 0; while (i < totalSamples && offset < buffer.length) { short val = (short) (32767.0 * Math.sin(phase)); buffer[offset++] = (byte) (val & 0xFF); buffer[offset++] = (byte) ((val >> 8) & 0xFF); phase += phaseIncrement; i++; } line.write(buffer, 0, offset); } line.drain(); line.stop(); line.close(); } public static void main(String[] args) throws Exception { playTone(880, 300); // A5 音，持续 300ms }}
为什么不用
Toolkit.getDefaultToolkit().beep()这个方法看似简单，但它依赖系统底层 beep 设备（Linux 的 pcspkr、Windows 的默认声音方案），经常被禁用、静音或映射到无意义音效。在服务器环境、Docker 容器或无桌面会话的 Linux 上大概率无声，且无法控制频率/时长。它不是音频合成，只是触发系统事件——不能算“Java 编程方式生成提示音”。
立即学习“Java免费学习笔记（深入）”；
- 无法指定音高、音长、波形
- macOS 上可能完全无效（自 macOS 10.15 起默认禁用传统 beep）
- 无异常抛出，失败时静默，调试困难
16-bit 正弦波字节序和缓冲区对齐细节
Java 的 SourceDataLine 默认期望小端序（little-endian）的 16-bit signed PCM 数据。short 转 byte[2] 时，必须先取低字节（val & 0xFF），再取高字节（(val >> 8) & 0xFF）。如果顺序反了，声音会严重失真甚至无声。
- 缓冲区大小（如
4096）应是帧大小的整数倍：16-bit 单声道 → 每帧 2 字节 → 缓冲区长度必须为偶数 - 写入
line.write()的字节数必须 ≤ 缓冲区长度，且最好每次写入 ≥ 1024 字节，避免频繁 syscall 开销 - 不要用
Math.round(Math.sin(...))，直接强转short更快，且Math.sin返回值严格在 [-1.0, 1.0] 内
实际使用要注意的边界情况
短于 50ms 的提示音可能被系统音频缓冲截断；高频（>4000Hz）在廉价扬声器上衰减明显；多线程并发调用 playTone 会冲突，因为 SourceDataLine 不是线程安全的。
- 若需连续多个音，应在同一
line实例上连续写入，而非反复 open/close - 首次调用可能有 100–300ms 延迟（JVM 音频子系统初始化），后续调用才稳定
- Linux 上若报
LineUnavailableException，检查是否被 PulseAudio 占用，可尝试加 JVM 参数：-Djavax.sound.sampled.SourceDataLine=DirectAudioDevice - Android 不支持
javax.sound.sampled，此代码仅适用于标准 JDK（Desktop/Server）
正弦波生成本身很简单，真正卡住人的永远是音频格式参数、字节序、缓冲区管理和平台差异。别跳过 AudioFormat 构造时的每一个字段含义。
