0

0

Java怎么播放MP3文件 Java使用JLayer库播放MP3音乐教程【附源码】

星降

星降

发布时间:2026-01-24 13:18:21

|

516人浏览过

|

来源于php中文网

原创

Java无法直接播放MP3,因javax.sound.sampled不支持压缩格式;须用JLayer解码为PCM后通过SourceDataLine输出,注意中文路径、缓冲区管理和资源释放。

java怎么播放mp3文件 java使用jlayer库播放mp3音乐教程【附源码】

Java 本身不原生支持 MP3 解码播放,javax.sound.sampled 只能处理 WAV、AIFF 等无压缩格式。想直接播放 MP3 文件,必须借助第三方解码库——JLayer 是最轻量、最常用的选择,但它只负责解码,不提供音频输出能力,需手动对接 SourceDataLine

为什么不能直接用 AudioSystem.play() 播放 MP3

AudioSystem.getAudioInputStream() 对 MP3 文件会抛出 UnsupportedAudioFileException,因为 JDK 内置的音频服务提供者(SPI)默认不注册 MP3 解码器。即使你把 MP3 文件路径传给 ClipAudioSystem.play(),也会静默失败或报错。

  • 常见错误信息:javax.sound.sampled.UnsupportedAudioFileException: could not get audio input stream from input URL
  • 不是路径写错,是格式不被识别
  • 别试图用 FileInputStream + AudioFormat 手动构造流——MP3 是有损压缩格式,必须先解码成 PCM

用 JLayer 解码 + SourceDataLine 播放的最小可行代码

核心逻辑:用 Player 类逐帧解码 MP3 为 PCM 字节数组,再通过 SourceDataLine 实时写入声卡。注意 JLayerPlayer 是阻塞式设计,适合简单播放;如需暂停/进度控制,得自己封装线程和缓冲。

import javazoom.jl.player.Player;
import javax.sound.sampled.*;
import java.io.FileInputStream;

public class MP3Player {
    public static void play(String mp3Path) throws Exception {
        FileInputStream fis = new FileInputStream(mp3Path);
        Player player = new Player(fis);

        // 获取 MP3 的采样率、位深、声道数(JLayer 会自动解析)
        // 但注意:JLayer 默认输出为 44100Hz、16-bit、stereo 的 PCM
        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);
        line.start();

        // 将解码后的 PCM 数据写入声卡
        byte[] buffer = new byte[4096];
        while (player.read(buffer) != -1) {
            line.write(buffer, 0, buffer.length);
        }

        line.drain();
        line.close();
        player.close();
        fis.close();
    }
}
  • 依赖需添加:javazoom:jlayer:1.0.1(Maven)或下载 jlayer-1.0.1.jar 手动引入
  • buffer 大小影响延迟和 CPU 占用:太小(如 1024)易卡顿;太大(如 16384)增加启动延迟
  • 该代码不处理异常中断(如用户关机),line.drain() 必须调用,否则末尾几毫秒声音会被截断

JLayer 播放常见坑与绕过方式

实际项目中容易卡在三个地方:中文路径乱码、播放卡顿、无法释放资源。这些问题和 JDK 版本、系统音频驱动、JLayer 自身实现都有关联。

koly.club
koly.club

一站式社群管理工具

下载

立即学习Java免费学习笔记(深入)”;

  • FileNotFoundException 但路径明明存在?→ Windows 下用 FileInputStream 读含中文路径的 MP3 会因编码问题失败,改用 Files.newInputStream(Paths.get(mp3Path))
  • 播放中途卡住不动?→ 多半是 SourceDataLine.write() 阻塞了,说明声卡缓冲区满。加个非阻塞检测:if (line.available()
  • 重复播放同一文件后声音变小或失真?→ SourceDataLine 未 close 导致设备被占用,下次 open 失败而降级到软件混音。务必确保 finally 块里调用 line.close()player.close()
  • 想播放网络 MP3(如 URL)?→ JLayer.Player 构造函数只接受 InputStream,可传 url.openStream(),但需自行处理 HTTP 超时和重定向

真正难的不是“怎么播出来”,而是“怎么播得稳、停得准、切得顺”。JLayer + SourceDataLine 组合没有内置事件回调,所有播放状态(是否结束、当前毫秒数)都要靠你自己计时、读取帧数、甚至反查 ID3 标签里的时长字段。如果项目需要暂停/拖动/多音轨,建议直接上 JavaFX MediaPlayer(支持 MP3,但需模块化运行时)或转 JNI 调用 libvlc

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

844

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

743

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

740

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

400

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

447

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

431

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16926

2023.08.03

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

17

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.8万人学习

C# 教程
C# 教程

共94课时 | 7.4万人学习

Java 教程
Java 教程

共578课时 | 50.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号