如何在JavaFX中同时播放两种音频？按钮悬停音效无输出问题

我设置了一首持续播放的背景音乐，想给按钮添加鼠标悬停时的额外音效。悬停触发的方法能正常执行，但没有音效输出，只有背景音乐在播放。以下是我的代码：

App.java #

public class App extends Application {

private static Scene scene;
private static MediaPlayer mediaPlayer;
private static Media media;
private String backSongURL = "path mp3";

final int sizeW = 640;
final int sizeH = 480;

@Override
public void start(@SuppressWarnings("exports") Stage stage) throws IOException {

    scene = new Scene(loadFXML("main"), sizeW, sizeH);
    stage.setScene(scene);
    stage.show();

    BackMusic();

}

static void setRoot(String fxml) throws IOException {
    scene.setRoot(loadFXML(fxml));
}

private static Parent loadFXML(String fxml) throws IOException {
    FXMLLoader fxmlLoader = new FXMLLoader(App.class.getResource(fxml + ".fxml"));
    return fxmlLoader.load();
}

public void BackMusic() { // 添加背景音乐

    media = new Media(new File(backSongURL).toURI().toString());
    mediaPlayer = new MediaPlayer(media);

    mediaPlayer.setCycleCount(999999999);
    mediaPlayer.setVolume(0.2);
    mediaPlayer.setAutoPlay(true);

}

public static void main(String[] args) {
    launch();
}
}

MainController(菜单控制器) #

@FXML
public void btnSong() { 

    media = new Media(new File(btnSongURL).toURI().toString());
    mediaPlayer = new MediaPlayer(media);

    mediaPlayer.setVolume(0.9);
    mediaPlayer.stop();

}

调试时btnSong方法能正常执行，但按钮悬停时没有音效输出，界面是用SceneBuilder建模并绑定代码的。

问题原因与解决方案 #

1. 播放逻辑错误：你创建音效的MediaPlayer后直接调用了stop()，相当于还没启动播放就停止了，自然没有声音。应该调用play()方法。

2. 覆盖背景音乐播放器：App类里的media和mediaPlayer是静态变量，控制器里直接赋值会覆盖掉背景音乐的播放器，不仅音效出不来，还可能导致背景音乐停止。需要为按钮音效单独创建局部的MediaPlayer实例，不要复用静态变量。

3. 路径与错误排查：确保btnSongURL指向的MP3文件路径正确，文件存在且格式支持。建议添加错误监听，排查加载或播放失败的原因。

修改后的控制器代码示例 #

@FXML
public void btnSong() { 
    // 确保btnSongURL已正确初始化（比如在控制器初始化时赋值）
    try {
        Media btnMedia = new Media(new File(btnSongURL).toURI().toString());
        // 监听媒体加载错误
        btnMedia.setOnError(() -> {
            System.err.println("音效加载失败：" + btnMedia.getError().getMessage());
        });
        
        MediaPlayer btnPlayer = new MediaPlayer(btnMedia);
        btnPlayer.setVolume(0.9);
        // 启动播放
        btnPlayer.play();
        
        // 播放结束后释放资源，避免内存泄漏
        btnPlayer.setOnEndOfMedia(btnPlayer::dispose);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

额外检查 #

• 确认FXML中按钮的事件绑定是onMouseEntered="#btnSong"（悬停触发），而不是onAction（点击触发）。
• 如果音效文件较小，建议提前预加载，避免悬停时加载延迟。

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