Flutter MIDI命令控制插件flutter_midi_command_platform_interface的使用

简介

flutter_midi_command 是一个用于在Flutter应用程序中发送和接收MIDI消息的插件，它可以在物理和虚拟MIDI设备之间进行通信。该插件通过薄层的Dart/Flutter包装了CoreMIDI（iOS）和android.media.midi（Android），支持USB、BLE MIDI连接（Android），以及USB、网络（会话）和BLE MIDI连接（iOS）。

快速开始

项目配置

由于此插件是使用Swift和Kotlin构建的，请确保你的Flutter项目支持这些语言环境。

导入库

在您的Dart文件中导入flutter_midi_command：

import 'package:flutter_midi_command/flutter_midi_command.dart';

基本操作

• 获取可用的MIDI设备列表：调用MidiCommand().devices以获得一系列MidiDevice对象。
• 启动蓝牙子系统：调用MidiCommand().startBluetoothCentral()。
• 监听蓝牙状态变化：调用MidiCommand().onBluetoothStateChanged()。
• 查询当前蓝牙状态：调用MidiCommand().bluetoothState()。
• 开始扫描BLE MIDI设备：调用MidiCommand().startScanningForBluetoothDevices()。
• 连接到特定的MIDI设备：调用MidiCommand.connectToDevice(selectedDevice)。
• 停止扫描BLE MIDI设备：调用MidiCommand().stopScanningForBluetoothDevices()。
• 断开当前设备连接：调用MidiCommand.disconnectDevice()。
• 订阅MIDI设置更新：订阅MidiCommand().onMidiSetupChanged。
• 监听来自当前设备的MIDI消息：订阅MidiCommand().onMidiDataReceived，之后将接收到作为变长UInt8List形式的传入MIDI消息。
• 发送MIDI消息：调用MidiCommand.sendData(data)，其中data是一个遵循MIDI规范的字节UInt8List。
• 使用MidiCommand的子类型发送PC、CC、NoteOn和NoteOff消息。
• 创建虚拟MIDI设备（仅iOS）：使用MidiCommand().addVirtualDevice(name: "Your Device Name")创建虚拟MIDI目的地和源。为了使这个功能正常工作，需要为您的应用启用后台音频，即向应用的info.plist文件添加键UIBackgroundModes，值为audio。

示例代码

以下是一个完整的示例demo，演示如何使用flutter_midi_command插件与MIDI设备交互。

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_midi_command/flutter_midi_command.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter MIDI Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MidiHomePage(),
    );
  }
}

class MidiHomePage extends StatefulWidget {
  @override
  _MidiHomePageState createState() => _MidiHomePageState();
}

class _MidiHomePageState extends State<MidiHomePage> {
  final MidiCommand midiCommand = MidiCommand();
  List<String> logMessages = [];

  void log(String message) {
    setState(() {
      logMessages.add(message);
    });
  }

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  // Platform messages are asynchronous, so we initialize in an async method.
  Future<void> initPlatformState() async {
    try {
      // 获取所有可用的MIDI设备
      List<MidiDevice> devices = await midiCommand.devices;
      for (var device in devices) {
        log('Found device: ${device.name}');
      }

      // 监听蓝牙状态变化
      midiCommand.onBluetoothStateChanged().listen((state) {
        log('Bluetooth state changed to $state');
      });

      // 开始扫描蓝牙设备
      midiCommand.startScanningForBluetoothDevices();

      // 监听MIDI数据接收
      midiCommand.onMidiDataReceived.listen((event) {
        log('Received MIDI data: ${event.data}');
      });
    } on PlatformException catch (e) {
      log('Failed to get platform version: ${e.message}');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter MIDI Demo'),
      ),
      body: ListView.builder(
        itemCount: logMessages.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text(logMessages[index]),
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () async {
          try {
            // 发送一个简单的MIDI Note On消息
            List<int> noteOnMessage = [0x90, 60, 127]; // Channel 1, Note C4, Velocity max
            await midiCommand.sendData(noteOnMessage);
            log('Sent Note On message');
          } catch (e) {
            log('Error sending MIDI message: $e');
          }
        },
        child: Icon(Icons.play_arrow),
      ),
    );
  }
}

此示例展示了如何初始化MIDI命令、获取并列出所有可用的MIDI设备、监听蓝牙状态的变化、开始扫描蓝牙设备、监听MIDI数据接收，并发送一个简单的MIDI Note On消息。希望这对您有所帮助！如果您有任何问题或需要进一步的帮助，请随时提问。