Java MIDI实时输入流获取与处理教程

本教程详细介绍了如何使用Java MIDI API从实时乐器获取MIDI输入流。针对传统Sequencer录制无法实时回调的问题，文章提出通过实现自定义Receiver接口来实时监听和处理MIDI消息，特别是NOTE_ON事件，从而实现即时响应和数据处理，适用于开发实时乐谱显示或互动应用。

实时MIDI输入处理的挑战

在开发需要与真实乐器（如数字钢琴）进行交互的应用时，例如实时乐谱显示、MIDI可视化工具或互动教学软件，核心需求是能够即时获取并处理来自乐器的MIDI输入。Java的MIDI API提供了强大的功能，但初学者在尝试实现实时回调时常会遇到挑战。

常见的做法是使用javax.sound.midi.Sequencer进行MIDI数据的录制，这可以将乐器演奏的MIDI事件保存到一个Sequence对象中，并最终写入MIDI文件。然而，这种方法主要侧重于数据的捕获和存储，难以在每个MIDI消息到达时提供即时、细粒度的回调。

例如，Sequencer提供的ControllerEventListener虽然可以监听控制器事件，但对于NOTE_ON、NOTE_OFF等核心音符事件的实时监听并不总是有效或直观，尤其是在录制模式下，其行为可能与预期不符，导致无法实现真正的即时响应。

核心解决方案：自定义Receiver

Java MIDI API为实时处理传入的MIDI消息提供了核心接口——javax.sound.midi.Receiver。当一个MIDI输入设备（通过Transmitter）接收到MIDI消息时，它会将这些消息发送给与之关联的Receiver。通过实现自定义的Receiver接口，我们能够精确地拦截并处理每一个实时到来的MIDI消息。

以下是一个自定义Receiver的实现示例，它能够识别并打印NOTE_ON、NOTE_OFF等ShortMessage类型的MIDI事件：

import javax.sound.midi.*;

/**
 * 自定义MIDI接收器，用于实时处理MIDI消息。
 */
private static class MyReceiver implements Receiver {

    @Override
    public void send(MidiMessage message, long timeStamp) {
        // 检查是否为ShortMessage，通常音符事件是ShortMessage
        if (message instanceof ShortMessage shortMessage) {
            // 获取MIDI命令，例如NOTE_ON (144) 或 NOTE_OFF (128)
            int command = shortMessage.getCommand();
            int channel = shortMessage.getChannel();
            int data1 = shortMessage.getData1(); // 音符编号或控制器编号
            int data2 = shortMessage.getData2(); // 速度或控制器值

            if (command == ShortMessage.NOTE_ON) {
                // 这是一个音符开启事件
                if (data2 > 0) { // 速度大于0表示音符按下
                    System.out.println("[Real-time] Note ON: Channel " + channel + ", Note " + data1 + ", Velocity " + data2 + " at tick " + timeStamp);
                    // 在这里执行您的实时处理逻辑，例如更新UI、比较音符等
                } else { // 速度为0有时也表示音符释放 (NOTE_OFF)
                    System.out.println("[Real-time] Note OFF (via ON with velocity 0): Channel " + channel + ", Note " + data1 + " at tick " + timeStamp);
                }
            } else if (command == ShortMessage.NOTE_OFF) {
                // 这是一个音符关闭事件
                System.out.println("[Real-time] Note OFF: Channel " + channel + ", Note " + data1 + ", Velocity " + data2 + " at tick " + timeStamp);
            } else if (command == ShortMessage.CONTROL_CHANGE) {
                // 控制器改变事件
                System.out.println("[Real-time] Control Change: Channel " + channel + ", Controller " + data1 + ", Value " + data2 + " at tick " + timeStamp);
            }
            // 可以根据需要处理其他ShortMessage类型，如Pitch Bend, Program Change等
        } else if (message instanceof SysexMessage) {
            // 系统专属消息，例如厂商特定的控制信息