JFugue MIDI和弦解析深度指南：理解onNoteParsed与潜在限制

import org.jfugue.parser.ParserListenerAdapter;
import org.jfugue.theory.Note;
import org.jfugue.player.Player;
import java.util.ArrayList;
import java.util.List;

/**
 * 用于从JFugue Staccato字符串中识别和弦的ParserListener。
 * 注意：此方法主要适用于Staccato字符串，不适用于MIDI文件。
 */
public class StaccatoChordIdentifier extends ParserListenerAdapter {
    private List<List<Note>> identifiedChords = new ArrayList<>();
    private List<Note> currentNoteGroup = new ArrayList<>();

    @Override
    public void onNoteParsed(Note note) {
        // 如果当前音符是新的“第一个音符”，并且我们之前已经收集了一组音符，
        // 则表示前一组（可能是一个和弦或一个独立音符）已经完成。
        // 在Staccato字符串中，isFirstNote()标记了一个新的音符序列的开始。
        if (note.isFirstNote()) {
            if (!currentNoteGroup.isEmpty()) {
                identifiedChords.add(new ArrayList<>(currentNoteGroup));
                currentNoteGroup.clear();
            }
        }
        // 将当前音符添加到当前组。它将是新组的第一个音符，
        // 或者是现有组中的和声/旋律音符。
        currentNoteGroup.add(note);

        // 打印音符及其标志，以便理解JFugue的解析行为
        System.out.println("解析音符: " + note.getToneString() +
                           " (八度: " + note.getOctave() +
                           ", 持续时间: " + note.getDuration() +
                           ", 是第一个音符: " + note.isFirstNote() +
                           ", 是和声音符: " + note.isHarmonicNote() +
                           ", 是旋律音符: " + note.isMelodicNote() + ")");
    }

    @Override
    public void onFinishedParsing() {
        // 解析完成后，确保将任何剩余的音符组添加进去
        if (!currentNoteGroup.isEmpty()) {
            identifiedChords.add(new ArrayList<>(currentNoteGroup));
        }
        System.out.println("\n--- 解析完成 ---");
        System.out.println("识别到的和弦/音符组:");
        for (List<Note> group : identifiedChords) {
            StringBuilder sb = new StringBuilder();
            sb.append("[");
            for (int i = 0; i < group.size(); i++) {
                sb.append(group.get(i).getToneString());
                if (i < group.size() - 1) {
                    sb.append(", ");
                }
            }
            sb.append("]");
            System.out.println(sb.toString() + (group.size() > 1 ? " (和弦)" : " (单音)"));
        }
    }

    public List<List<Note>> getIdentifiedChords() {
        return identifiedChords;
    }

    public static void main(String[] args) {
        Player player = new Player();
        StaccatoChordIdentifier listener = new StaccatoChordIdentifier();

        // 示例 Staccato 字符串
        String staccatoMusic = "Cmajq Dminh Gww A"; // C大调四分音符，D小调二分音符，G全音符，A单音
        // 理论上 Cmajq 会被解析为 C+E+G，Dminh 为 D+F+A，Gww 为 G+B+D
        // 但实际JFugue Staccato字符串解析时，"Cmaj"直接解析为C,E,G三个音符，每个音符都会有自己的isFirstNote/isHarmonicNote/isMelodicNote标志
        // 让我们测试一个更明确的和弦表示
        String complexChordString = "Cq+Eq+Gq Rh Dmajq"; // C和弦，休止符，D大调和弦
        String arpeggiatedChord = "C E G C5"; // 琶音，JFugue会将其视为独立音符序列
        String combined = "Cmajq A5h C+E+G+C5w"; // 混合示例

        System.out.println("--- 解析 Staccato 字符串: " + staccatoMusic + " ---");
        player.parse(staccatoMusic, listener);
        listener = new StaccatoChordIdentifier(); // 重置监听器
        System.out.println("\n--- 解析 Staccato 字符串: " + complexChordString + " ---");
        player.parse(complexChordString, listener);
        listener = new StaccatoChordIdentifier(); // 重置监听器
        System.out.println("\n--- 解析 Staccato 字符串: " + combined + " ---");
        player.parse(combined, listener);
    }
}