本文适合有 Java 基础知识的人群，跟着本文可学习和运行 Java 版桌面 DJ 音乐播放器。

本文作者：HelloGitHub-秦人

HelloGitHub 推出的《讲解开源项目》系列，今天给大家带来一款开源 Java 版桌面 DJ 音乐播放器项目——XR3Player，它强大的功能和炫酷的展示效果，你肯定会喜欢上它的！

项目源码地址：https://github.com/goxr3plus/XR3Player

一、项目介绍

OpenJFX 是一个开源的下一代客户端应用程序平台，适用于基于 Java 构建的桌面、移动和嵌入式系统。本篇我们就重点讲一下一款 Java 版桌面 DJ 音乐播放器，先看运行效果吧！

也可以直接下载音乐播放器安装包：下载地址，更多 Java 桌面程序可以从这里获取：openjfx.io

二、运行项目

2.1 前提

• 安装 JDK11.2 或者更高版本，全称 Java Development Kit，它是 Java 的库函数，是编译、运行 Java 程序的工具包。
• 安装 Maven3 环境，进行项目构建和项目依赖包管理。
• 本地安装开发工具 IntelliJ IDEA。
• 本地安装 GitBash 工具，主要用于下载项目。

2.2 下载项目

下载项目到本地，使用 GitBash 工具，执行如下命令：

git clone https://github.com/goxr3plus/XR3Player.git

将项目导入 Idea，Maven 会自动下载所需的依赖。等待几分钟后项目依赖包都可以下载下来。使用 Idea 自带的 Maven 构建工具，就可以将项目轻松打包。如下图：

注意项目有一个依赖 jxbrowser-win64 可能会下载失败，这个 jar 竟然有 40Mb，建议手动下载后导入项目依赖。jxbrowser-win64 下载地址

2.3 运行项目

创建入口类

打开 Run/Debug Configurations 创建一个 Application ，并选择入口类，如下图：

VM options 设置

VM options 添加下面配置参数,然后点击保存即可。

然后点击 Run Main 或 Debug Main 就可以本地运行项目了。如下图：

三、音乐播放器使用

项目运行起来长这样子，如下图：

1、需要创建一个用户，点击登录就可以进入音乐播放器管理页面。

2、进入音乐播放器，需要创建自己的音乐播放列表，并导入本地音乐。

3、导入本地音乐后可选择，选择需要播放的音乐，这里直接拖动你想播放的音乐。

4、DJ 版播放器可以同步播放两首歌曲，并可以分别控制音量和播放速度。

5、音乐播放器内嵌了浏览器，和在线音乐的功能。

6、其他的功能期待你的发掘，如果你也喜欢这款音乐播放器的话。

四、JavaFx 工作原理

JavaFX 的原理是这样的（如下图）：舞台（Stage），场景（Scene），容器（Container），布局（Layout）和控件（Controls）之间的关系：

在 JavaFX 中，Stage 是应用程序窗口，其中包含称为 Scene 的空间。Scene 包含界面的组件，如 UI 空间（按钮，输入框，复选框），容器等。

创建 JavaFx 项目

打开 Idea 开发工具，File -> New -> Project... -> Java Fx 创建项目，如下图：

Idea 会自动生成代码，这里我做了一些改动，代码如下：

代码运行效果如下图：

了解 Java Swing 的伙伴应该很熟悉，两者的原理很相似。上面代码的意思是：创建一个面板，然后在面板上添加标签，输入框和按钮，并对按钮添加绑定事件，然后把这个面板添加到场景中，这个窗口就完成了。

五、最后

Java 桌面 DJ 音乐播放器是真的香！不知道你对这款音乐播放器有什么感受，欢迎在评论区说说自己的想法。人们都喜欢美的好的事物，而今天的这个项目是通过 Java 代码撸出来的，难道你还不会不喜欢 Java 这门编程语言吗？有了成品的直观呈现，才能在视觉上产生更强的冲击，可能会更加能激发你的学习动力！如果通过我的内容分享，能让你对编程产生兴趣，我是真的开心。如果渐渐喜欢上开源项目，平时也喜欢 coding，并且愿意分享你的经验和成果，那就更完美了，编程使我快乐，内容分享让我们认识更多伙伴！

教程至此，你应该也能快速运行 DJ 版音乐播放器了。编程是不是也特别有意思呢？手痒痒了那就赶紧安装这款音乐播放器吧，对源码感兴趣的朋友可以开始学习项目源码了～

六、参考资料

• 官方文档
• 入门教程

『讲解开源项目系列』——让对开源项目感兴趣的人不再畏惧、让开源项目的发起者不再孤单。跟着我们的文章，你会发现编程的乐趣、使用和发现参与开源项目如此简单。欢迎留言联系我们、加入我们，让更多人爱上开源、贡献开源～