如何使用Dart/Flutter控制MIDI设备实现MIDI输入输出功能？

目前Dart生态没有覆盖全平台、可直接用的MIDI通信包，最稳定可落地的方案是「Dart层实现MIDI协议解析封装 + 平台通道调用系统原生MIDI API」，不需要依赖第三方SDK，适配Novation Launchpad这类固定功能的MIDI控制器时，不需要实现全量MIDI协议，开发量很低。

Dart层核心逻辑实现 #

先在Dart侧完成MIDI消息的解析、封装，这部分逻辑全平台通用，不需要分平台写。
Novation Launchpad全系列只用到3类基础MIDI消息，不需要处理复杂的系统专有消息、MIDI时钟等冗余内容：

• Note On（状态字节0x90）：对应按键按下事件，也用来向设备发送亮灯指令
• Note Off（状态字节0x80）：对应按键抬起事件，也用来发送灭灯指令
• Control Change（状态字节0xB0）：对应顶部功能键、模式切换事件

核心代码示例：

/// 适配Launchpad的MIDI消息处理类
class LaunchpadMidi {
  /// 从原始字节解析输入的MIDI消息
  static MidiEvent? parseInput(List<int> rawBytes) {
    if (rawBytes.length < 3) return null;
    final status = rawBytes[0] & 0xF0;
    // 过滤无关的系统消息
    if (!const [0x90, 0x80, 0xB0].contains(status)) return null;
    return MidiEvent(
      type: status,
      keyOrCc: rawBytes[1],
      value: rawBytes[2],
    );
  }

  /// 构建点亮指定按键的输出指令
  static List<int> buildLightCmd(int padIndex, int colorCode) {
    return [0x90, padIndex, colorCode];
  }

  /// 构建熄灭指定按键的输出指令
  static List<int> buildLightOffCmd(int padIndex) {
    return [0x80, padIndex, 0x00];
  }

  /// 构建设备复位指令，连接成功后发送让Launchpad进入程序员模式
  static List<int> buildResetCmd() {
    return [0xB0, 0x00, 0x00];
  }
}

class MidiEvent {
  final int type;
  final int keyOrCc;
  final int value;
  MidiEvent({required this.type, required this.keyOrCc, required this.value});
}

你只需要对照手头Launchpad型号的官方编程手册，补一份按键位置和Note/CC编号的映射表、颜色编码常量表即可，这部分内容都是固定公开的。

平台侧通信桥接实现 #

MIDI能力是各系统原生自带的，不需要引入第三方依赖，通过Flutter的MethodChannel/EventChannel做桥接即可：

• Android端：调用系统android.media.midi包，枚举已连接的USB MIDI设备，通过Novation的厂商VID（0x1235）筛选出Launchpad设备，打开输入输出端口。输入端口收到的原始字节通过EventChannel推送到Dart层，Dart层下发的亮灯等指令通过MethodChannel传到原生层写入输出端口即可，注意要提前申请USB设备访问权限。
• iOS/macOS端：调用系统CoreMIDI框架，枚举MIDI设备匹配Launchpad的设备标识，创建输入输出端口，逻辑和Android端一致，记得在Info.plist添加外接USB设备的访问权限声明。
• Windows端：调用系统WinMM接口枚举MIDI输入输出设备，匹配Launchpad设备名后建立读写连接即可。
• 如果只需要支持桌面全平台，也可以直接用dart:ffi绑定系统MIDI对应的动态库，省去写Flutter插件桥接的工作量。

Launchpad适配注意事项 #

• 设备首次连接成功后，必须先发复位指令让设备切到程序员模式，否则设备会默认进入DAW控制模式，按键映射、灯控逻辑都会和预期不符。
• 输入消息处理时加10ms的去重逻辑，Launchpad固件偶尔会重复触发同一个按键的Note On消息，容易导致业务逻辑重复执行。
• 不需要处理变长MIDI消息，Launchpad的所有交互都是3字节固定长度的基础消息，直接按3字节切片解析即可，能省掉很多字节流处理的坑。
• 不要尝试用仅支持Web的MIDI包做原生端适配，这类包在移动端、桌面端无法调用系统MIDI能力，完全跑不通。

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