JavaFX无法播放视频：启动后仅显示黑屏问题求助

咱们一步步来找出问题所在：

1. 先确认视频文件路径是否正确 #

你的代码里用了相对路径拼接，但实际运行时的user.dir可能和你预期的不一样。建议在创建File对象后，打印出实际路径，确认文件真的存在：

File f = new File(Dir, "test.mp4");
// 新增这行打印路径
System.out.println("实际视频路径：" + f.getAbsolutePath());
if (!f.exists()) {
    System.err.println("视频文件不存在！");
    return;
}

如果文件不存在，检查你的输出目录结构，或者改成绝对路径先测试。

2. 修正Duration的错误用法 #

你代码里的Duration.valueOf("50")是错误的，这个方法需要带单位的字符串（比如"50s"表示50秒，"50ms"表示50毫秒），直接写"50"会抛出IllegalArgumentException，这个异常会导致媒体初始化失败。改成：

// 比如要减去50秒
player.setStopTime(media.getDuration().subtract(Duration.seconds(50)));

或者用Duration.valueOf("50s")，确保格式正确。

3. 添加错误监听，查看具体报错 #

给MediaPlayer加上错误监听，这样能直接看到播放失败的原因：

player.setOnError(() -> {
    System.err.println("播放错误信息：");
    System.err.println(player.getError().getMessage());
    if (player.getError().getMediaException() != null) {
        player.getError().getMediaException().printStackTrace();
    }
});

运行后控制台会输出具体错误，比如编码不支持、文件损坏等。

4. 检查视频编码是否符合JavaFX要求 #

JavaFX对MP4的编码有严格要求，仅支持H.264（AVC）视频编码和AAC音频编码的MP4文件。如果你的视频是其他编码（比如VP9、MPEG-4 Part 2），就会出现黑窗口无法播放的情况。

你可以用FFmpeg转码，命令示例：

ffmpeg -i test.mp4 -c:v libx264 -c:a aac -strict -2 output.mp4

用转码后的output.mp4测试，看是否能正常播放。

5. 暂时关闭全屏，排除渲染问题 #

有时候全屏模式可能会导致渲染异常，先注释掉stage.setFullScreen(true);，用窗口模式测试，如果能播放，再排查全屏的配置问题（比如添加全屏权限，或者设置场景的全屏策略）。

6. 简化代码，先做最小测试 #

把代码简化到最基础的播放逻辑，排除其他干扰：

@Override
public void start(Stage stage) throws Exception {
    // 先用绝对路径测试
    File f = new File("D:\\your-path\\test.mp4");
    Media media = new Media(f.toURI().toString());
    MediaPlayer player = new MediaPlayer(media);
    MediaView viewer = new MediaView(player);

    player.setOnError(() -> System.err.println("错误：" + player.getError().getMessage()));
    player.setOnReady(() -> {
        System.out.println("媒体已准备就绪，时长：" + media.getDuration());
        player.play();
    });

    StackPane root = new StackPane(viewer);
    Scene scene = new Scene(root, 800, 600, Color.BLACK);
    stage.setScene(scene);
    stage.setTitle("测试视频播放");
    stage.show();
}

如果这个简化版本能播放，再逐步加回你原来的逻辑（比如设置开始/结束时间、全屏等），找到问题所在。

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