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 是阻塞式设计,适合简单播放;如需暂停/进度控制,得自己封装线程和缓冲。

OneAI
OneAI

将生成式AI技术打包为API,整合到企业产品和服务中

下载
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 自身实现都有关联。

立即学习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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

846

2023.08.22

length函数用法
length函数用法

length函数用于返回指定字符串的字符数或字节数。可以用于计算字符串的长度,以便在查询和处理字符串数据时进行操作和判断。 需要注意的是length函数计算的是字符串的字符数,而不是字节数。对于多字节字符集,一个字符可能由多个字节组成。因此,length函数在计算字符串长度时会将多字节字符作为一个字符来计算。更多关于length函数的用法,大家可以阅读本专题下面的文章。

954

2023.09.19

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

764

2023.08.10

Java 并发编程高级实践
Java 并发编程高级实践

本专题深入讲解 Java 在高并发开发中的核心技术,涵盖线程模型、Thread 与 Runnable、Lock 与 synchronized、原子类、并发容器、线程池(Executor 框架)、阻塞队列、并发工具类(CountDownLatch、Semaphore)、以及高并发系统设计中的关键策略。通过实战案例帮助学习者全面掌握构建高性能并发应用的工程能力。

99

2025.12.01

点击input框没有光标怎么办
点击input框没有光标怎么办

点击input框没有光标的解决办法:1、确认输入框焦点;2、清除浏览器缓存;3、更新浏览器;4、使用JavaScript;5、检查硬件设备;6、检查输入框属性;7、调试JavaScript代码;8、检查页面其他元素;9、考虑浏览器兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

197

2023.11.24

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1476

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1169

2023.07.27

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

4

2026.03.10

热门下载

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

精品课程

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

共23课时 | 4.3万人学习

C# 教程
C# 教程

共94课时 | 11.1万人学习

Java 教程
Java 教程

共578课时 | 80.1万人学习

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

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