Java标准库不支持MP3播放,因其仅内置PCM解码器;需用JLayer等第三方库解码为PCM流后通过SourceDataLine输出,并注意格式匹配、线程安全及跨平台设备适配。

Java 标准库(javax.sound.sampled)能播放 WAV、AIFF、AU 等无压缩或线性编码格式,但**不支持 MP3、FLAC、AAC 等主流格式**——直接用 AudioSystem.getAudioInputStream() 加载 MP3 会抛 UnsupportedAudioFileException。
为什么 AudioSystem 无法播放 MP3
Java SE 自带的音频引擎只实现 SPI 接口的默认提供者,仅覆盖 PCM 类型。MP3 是有损压缩格式,解码需额外 codec,而 Oracle 官方从未在 JDK 中内置 MP3 解码器。
- 尝试用
AudioSystem.getAudioInputStream(new File("song.mp3"))会立即失败 - 即使文件后缀是 .wav,若实际为 MP3 重命名,仍会报
Unsupported format: MPEG -
AudioFormat.getEncoding()返回AudioFormat.Encoding.PCM_SIGNED才算可播;MP3 对应的是AudioFormat.Encoding.MPEG,不被原生支持
用 JLayer 实现 MP3 播放(轻量可靠)
JLayer 是成熟开源库,纯 Java 实现,只需一个 jlayer-1.0.1.jar(约 180KB),通过 AdvancedPlayer 将 MP3 解码为 PCM 流,再喂给 SourceDataLine 输出。
- 添加依赖:
compile files('libs/jlayer-1.0.1.jar')(Gradle)或手动加到 classpath - 关键步骤:用
new FileInputStream("a.mp3")构造Player,调player.play(1)播放 1 帧(阻塞),或用新线程调player.play() - 暂停/继续需自行管理线程中断,JLayer 本身不提供 pause API;建议封装
volatile boolean paused+ 循环中检查 - 音量控制不可直接操作,需在解码后对 PCM 字节数组做幅度缩放(例如乘以 0.5)
避免 AudioFormat 不匹配导致无声
不同 MP3 文件采样率、位深、声道数各异,SourceDataLine 要求严格匹配。JLayer 解码输出默认是 44100Hz、16-bit、stereo、little-endian PCM,但部分设备只接受 big-endian 或 mono。
立即学习“Java免费学习笔记(深入)”;
- 务必用
AudioFormat targetFormat = new AudioFormat( Encoding.PCM_SIGNED, 44100, 16, 2, 4, 44100, false)显式声明 - 获取 line 前先查可用信息:
AudioSystem.getSourceDataLine(targetFormat),失败则遍历AudioSystem.getMixer(null).getSourceLines(info)找兼容设备 - Windows 上常见错误
LineUnavailableException,多因系统独占了默认设备,可尝试设置System.setProperty("javax.sound.sampled.noMixer", "true")绕过
进度监听与线程安全的实际处理
JLayer 不提供播放位置回调,必须自己计时+帧长估算。MP3 帧长不固定(CBR 可算,VBR 需解析 Xing header),简单项目可按平均帧长(如 26ms/frame)粗略推进。
- 启动播放时记录
System.nanoTime(),每 decode 一帧更新进度:elapsedMs = (frameCount * 26) - UI 更新(如
JSlider.setValue())必须在 Event Dispatch Thread 执行,用SwingUtilities.invokeLater() - 停止播放时,
player.close()并置空引用;否则残留线程可能阻止 JVM 退出 - 多个音频同时播放需为每个分配独立
SourceDataLine,共享 line 会导致混音异常或崩溃
真正麻烦的不是播放逻辑,而是格式兼容性判断和设备适配——同一段代码在 macOS 上可能自动选对 mixer,在 Linux ALSA 下却要手动指定 device name。上线前务必在目标环境实测 AudioSystem.getMixerInfo() 列出的全部设备。











