The MidiBus 开源项目教程

项目介绍

The MidiBus 是一个为 Processing 设计的 MIDI 库，旨在提供快速且简便的方式来发送和接收 MIDI 数据。该库主要设计用于实时 MIDI 应用，专注于 MIDI 输入输出，并尽量减少不必要的功能。目前，The MidiBus 没有内置的音序器、文件读写或 MIDI 录制/回放功能。

项目快速启动

安装

1. 克隆项目仓库：

   git clone https://github.com/sparks/themidibus.git
   

2. 将项目导入你的 Processing 开发环境。

示例代码

以下是一个简单的示例代码，展示如何在 Processing 中使用 The MidiBus 发送和接收 MIDI 消息：

import themidibus.*; // 导入 The MidiBus 库

MidiBus myBus; // 声明一个 MidiBus 对象

void setup() {
  size(400, 400);
  MidiBus.list(); // 列出所有可用的 MIDI 设备
  myBus = new MidiBus(this, -1, "OutputDeviceName"); // 创建 MidiBus 对象，连接到指定的输出设备
}

void draw() {
  background(0);
}

void mousePressed() {
  int channel = 0;
  int pitch = 60;
  int velocity = 127;
  myBus.sendNoteOn(channel, pitch, velocity); // 发送 NoteOn 消息
}

void mouseReleased() {
  int channel = 0;
  int pitch = 60;
  int velocity = 0;
  myBus.sendNoteOff(channel, pitch, velocity); // 发送 NoteOff 消息
}

应用案例和最佳实践

实时 MIDI 控制

The MidiBus 非常适合用于实时 MIDI 控制，例如通过鼠标或键盘事件来控制 MIDI 设备。以下是一个通过键盘控制 MIDI 音符的示例：

void keyPressed() {
  int channel = 0;
  int pitch = key;
  int velocity = 127;
  myBus.sendNoteOn(channel, pitch, velocity);
}

void keyReleased() {
  int channel = 0;
  int pitch = key;
  int velocity = 0;
  myBus.sendNoteOff(channel, pitch, velocity);
}

MIDI 数据记录与回放

虽然 The MidiBus 本身不支持 MIDI 文件的读写，但你可以结合其他库或自定义代码来实现 MIDI 数据的记录与回放。例如，你可以记录 MIDI 消息并在需要时重新发送它们。

典型生态项目

Processing

The MidiBus 主要用于 Processing 开发环境，Processing 是一个开源的编程语言和集成开发环境，主要用于视觉艺术和互动设计。

mmj

对于 Mac 用户，建议安装 mmj，这是一个 Mac OS X 的通用二进制 Java MIDI 子系统。mmj 提供了对一些高级 MIDI 功能的支持，而这些功能在 Apple 的实现中是缺失的。

其他 MIDI 库

除了 The MidiBus，还有其他一些 MIDI 库可以与 Processing 结合使用，例如 Beads 和 Minim，这些库提供了音频处理和 MIDI 控制的功能。

通过这些模块的介绍和示例代码，你应该能够快速上手并使用 The MidiBus 进行 MIDI 开发。