基于JFugue开发虚拟钢琴项目，如何获取player当前播放的音符用于琴键可视化？

完全支持获取播放过程中的实时音符事件，不需要手动计算播放时间偏移，对正在学习Java的开发者也比较友好。

• 核心实现依靠JFugue内置的监听机制，不需要额外引入第三方依赖。你只需要给Player实例注册自定义的PlayerListener，就可以接收播放过程中的各类事件，不需要自己拆解曲谱、追踪播放时间来匹配当前音符。
• 重点关注两个和音符状态直接相关的回调方法即可：
  • onNotePlayed(Note note)：在音符刚触发发声的瞬间被调用，你可以直接从传入的Note对象拿到当前播放音符的MIDI编码（调用note.getValue()即可获取整数形式的MIDI值），用来触发虚拟钢琴对应按键的高亮、按下状态。
  • onNoteReleased(Note note)：在音符播放结束、声音停止的瞬间被调用，拿到对应MIDI编码后，就可以把虚拟钢琴上对应按键的高亮状态取消，模拟抬键的效果。
• 参考最小可运行的代码结构，不需要复杂的封装：

// 初始化JFugue播放器
Player player = new Player();
// 给播放器添加自定义监听逻辑
player.addPlayerListener(new PlayerListener() {
    @Override
    public void onNotePlayed(Note note) {
        int currentNoteMidi = note.getValue();
        // 把音符信息传给虚拟钢琴界面的按键高亮方法
        // 注意：操作Swing/JavaFX这类桌面UI时，需要把这段UI更新代码切到对应框架的UI线程执行
        virtualPianoUI.setKeyHighlight(currentNoteMidi, true);
    }

    @Override
    public void onNoteReleased(Note note) {
        int releasedNoteMidi = note.getValue();
        virtualPianoUI.setKeyHighlight(releasedNoteMidi, false);
    }
    // 接口中其他未用到的方法，保持空实现即可，IDE会自动补全所有需要实现的方法
});
// 正常加载你提前转录好的示例曲目播放即可，对应的音符事件会自动触发
player.play("T90 C E G C5 E G C6");

• 针对Java新手的几个避坑提示：
  • 线程安全问题：JFugue的监听器回调是在独立的播放线程中执行的，不要直接在回调方法里修改UI组件的状态，不然会出现界面卡顿、无响应的问题。如果用Swing写虚拟钢琴界面，就用SwingUtilities.invokeLater()把UI更新操作切到事件 dispatch 线程执行；如果用JavaFX，就用Platform.runLater()完成线程切换。
  • 不要自己写定时任务轮询Player的播放进度，再对照你整理的曲谱反推当前播放的音符。这种方法长时间播放后会出现时间偏移，遇到延音、装饰音这类复杂曲谱片段时，还会出现按键高亮和声音不同步的问题，用内置的监听接口是准确性最高、代码量最少的方案。
  • 如果你使用的是较早版本的JFugue，对应的监听器方法名可能存在微小差异，但核心的「音符开始触发」「音符结束释放」的事件回调逻辑是完全一致的，对照你当前使用版本的API说明调整方法名即可，不需要改动整体逻辑。

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