JavaFX11实现节点自动循环播放的Media类导入及依赖配置咨询

你没有记错功能对应的API，javafx.scene.media.Media 确实是JavaFX实现本地媒体播放的核心类，导入失败根本不是你对API的记忆出了问题：

• 从JavaFX 11开始，Oracle正式把JavaFX从JDK的绑定组件里拆了出去，后续所有JavaFX功能都不再随标准JDK安装包内置，必须作为独立依赖引入项目
• JavaFX本身按功能拆成了独立的模块化组件，媒体播放能力归属于单独的javafx.media模块，这个模块不会被打包进javafx.controls这类基础UI控件模块里——哪怕你已经引了基础JavaFX的依赖，没加media模块的话，是根本导不进来Media类的。

按照下面的步骤配置就能解决导入失败和运行时报错的问题：

• 严格对齐依赖版本：引入OpenJFX依赖时，所有JavaFX相关模块的版本必须完全一致，匹配项目使用的JDK版本（比如JDK11就对应OpenJFX 11.x的长期支持版本，不要跨大版本混引，很容易出现模块签名冲突）
• 单独引入媒体模块：在Maven/Gradle的依赖配置中，手动添加javafx-media模块依赖，不要只加javafx-controls、javafx-fxml这类基础模块；依赖要匹配你本地运行的操作系统类型，不然会出现原生媒体库加载失败的问题
• 补全模块系统声明：
  • 如果项目存在module-info.java文件，必须在requires语句里加上requires javafx.media;
  • IntelliJ的运行配置里，要在VM选项中补充--add-modules javafx.controls,javafx.media，只声明controls模块是不够的，不然启动时会直接报media模块未解析的类不可见错误
• 清理无效的旧配置：把项目里绑定旧版JDK的JavaFX facet删掉，把项目SDK设置为和引入的OpenJFX版本兼容的JDK（11及以上版本）

等依赖集成完成后，用Media类加载视频源创建Media实例，再初始化对应的MediaPlayer对象时，直接调用mediaPlayer.setCycleCount(MediaPlayer.INDEFINITE)，就能实现无限自动循环播放，不需要自己写播放状态监听、重播触发的冗余逻辑。

内容的提问来源于stack exchange，提问作者nbulgarides