Flutter MIDI处理插件midi_util的使用

发布于 1周前 作者 vueper 来自 Flutter

Flutter MIDI处理插件midi_util的使用

midi_util 是一个纯 Dart 库，允许你在 Dart 程序中编写多轨音乐乐器数字接口（MIDI）文件（支持格式1和格式2文件）。它是一个面向对象的库，可以让你以最少的麻烦创建并写入这些文件。

该库受到 Mark Conway Wirt 开发的 Python 库 MIDIUtil 的启发。

midi_util 并不是完整的 MIDI 规范实现。实际的规范是一份庞大而复杂的文档，经过多年的发展逐渐形成。我有选择性地实现了其中一些更常用和常见的部分。尽管如此，代码相当容易理解且结构良好。对于有良好 MIDI 文件格式知识和 Dart 编程能力的人来说，可以对库进行扩展。提供了扩展库的文档。

该软件根据开源许可证分发，你可以自由使用，只要保持对原作者的署名。详情请参阅源码中的 License.txt。

快速开始

使用该软件非常简单：

  • 包必须导入到你的命名空间中。
  • 创建一个 MIDIFile 对象。
  • 向对象中添加事件（如音符、改变速度等）。
  • 将 MIDI 文件写入磁盘。

详细的文档已经提供；以下是一个简单的示例来帮助你快速上手。在这个示例中，我们将创建一个单轨 MIDI 文件，为该轨道分配一个速度，并写入一个 C 大调音阶。然后将其写入磁盘。

import 'dart:io';

import 'package:midi_util/midi_util.dart';

void main() {
  List notes = [60, 62, 64, 65, 67, 69, 71, 72]; // MIDI 音符编号
  var track = 0;
  var channel = 0;
  var time = 0; // 在拍子中
  var duration = 0.5; // 在拍子中
  var tempo = 60; // 每分钟节拍数
  var volume = 100; // 0-127，按 MIDI 标准

  MIDIFile myMIDI = MIDIFile(numTracks: 2);
  myMIDI.addTempo(
    track: track,
    time: time,
    tempo: tempo,
  );
  myMIDI.addKeySignature(
      track: track,
      time: time,
      no_of_accidentals: 0,
      accidental_mode: AccidentalMode.MAJOR,
      accidental_type: AccidentalType.SHARPS);

  List.generate(notes.length, (i) {
    myMIDI.addNote(
        track: track,
        channel: channel,
        pitch: notes[i],
        time: time + i,
        duration: duration,
        volume: 100);
  });

  var outputFile = File('c_scale.mid');
  myMIDI.writeFile(outputFile);
}

更多关于Flutter MIDI处理插件midi_util的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter MIDI处理插件midi_util的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，下面是一个关于如何在Flutter项目中使用midi_util插件处理MIDI数据的示例代码。这个插件允许你读取和写入MIDI文件，以及处理MIDI消息。

首先，确保你已经在pubspec.yaml文件中添加了midi_util依赖：

dependencies:
  flutter:
    sdk: flutter
  midi_util: ^最新版本号 # 请替换为实际发布的最新版本号

然后，运行flutter pub get来安装依赖。

接下来是一个简单的Flutter应用示例，它展示了如何使用midi_util插件来读取一个MIDI文件并解析其中的消息：

import 'package:flutter/material.dart';
import 'package:midi_util/midi_util.dart';
import 'dart:typed_data';
import 'dart:convert';

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  Uint8List? midiData;
  List<MidiMessage>? midiMessages;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('MIDI Util Demo'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                onPressed: _loadMidiFile,
                child: Text('Load MIDI File'),
              ),
              if (midiMessages != null)
                Expanded(
                  child: ListView.builder(
                    itemCount: midiMessages!.length,
                    itemBuilder: (context, index) {
                      final message = midiMessages![index];
                      return ListTile(
                        title: Text('Message ${index + 1}: ${message.toString()}'),
                      );
                    },
                  ),
                ),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> _loadMidiFile() async {
    // 这里你可以从文件或其他来源加载MIDI数据
    // 为了简单起见，这里我们假设有一个硬编码的MIDI文件内容（Base64编码）
    String base64MidiData = 'TVRoZAAABwBM...'; // 请替换为实际的Base64编码MIDI数据
    Uint8List midiBytes = base64Decode(base64MidiData);

    setState(() {
      midiData = midiBytes;
      midiMessages = MidiFile.parse(midiBytes).messages;
    });
  }
}

在这个示例中，我们做了以下几件事：

  1. 在pubspec.yaml中添加了midi_util依赖。
  2. 创建了一个简单的Flutter应用，包含一个按钮和一个列表视图。
  3. 当用户点击按钮时，从硬编码的Base64字符串中加载MIDI数据（在实际应用中，你可能会从文件或其他来源加载数据）。
  4. 使用MidiFile.parse方法解析MIDI数据，并将解析出的MIDI消息存储在midiMessages列表中。
  5. 在列表视图中显示解析出的MIDI消息。

请注意，硬编码的Base64字符串应该被替换为实际的MIDI文件内容的Base64编码。你可以使用在线工具将MIDI文件转换为Base64编码字符串，或者从文件中读取数据并进行Base64编码。

此外，midi_util插件还提供了其他功能，如创建MIDI文件和生成MIDI消息。你可以查阅插件的文档以了解更多详细信息。

回到顶部