MidiBus 项目技术文档

1. 安装指南

通过 Processing Library Manager 安装

1. 打开 Processing 软件。
2. 进入菜单栏，选择 工具 -> 添加工具。
3. 在弹出的窗口中，选择 库 标签。
4. 搜索 MidiBus，找到后点击 安装 按钮。
5. Processing 会自动下载并安装最新版本的 MidiBus 库。

手动安装

1. 下载最新版本的 MidiBus 库压缩包，地址为 themidibus-latest.zip。
2. 解压下载的压缩包。
3. 将解压后的文件夹复制到 Processing 的库目录中，通常位于 Documents/Processing/libraries。
4. 重启 Processing 软件，MidiBus 库即可使用。

2. 项目的使用说明

快速开始

MidiBus 是一个为 Processing 设计的 MIDI 库，主要用于实时 MIDI 应用。它专注于 MIDI 输入输出，并尽量减少不必要的功能。目前，MidiBus 不包含内置的音序器、文件读写、MIDI 录制/回放等功能。

示例代码

MidiBus 提供了一些示例代码，帮助用户快速上手。最简单的示例是 Basic.pde，用户可以从这个示例开始学习如何使用 MidiBus。

JavaDocs

MidiBus 的 JavaDocs 提供了所有功能的详细说明，用户可以通过在线文档或本地库中的 reference 目录查看。

3. 项目API使用文档

主要类和方法

• MidiBus：主要类，用于管理 MIDI 输入和输出设备。
• sendNoteOn(int channel, int pitch, int velocity)：发送 MIDI Note On 消息。
• sendNoteOff(int channel, int pitch, int velocity)：发送 MIDI Note Off 消息。
• sendControlChange(int channel, int number, int value)：发送 MIDI Control Change 消息。
• sendPitchBend(int channel, int value)：发送 MIDI Pitch Bend 消息。

高级功能

• 支持多输入/输出设备的管理。
• 支持发送和接收不常见的 MIDI 消息。

4. 项目安装方式

通过 Processing Library Manager 安装

如前所述，通过 Processing 的库管理器可以方便地安装 MidiBus。

手动安装

手动安装需要下载并解压库文件，然后将其放置在 Processing 的库目录中。

注意事项

• 在 macOS 上，Apple 的 MIDI 子系统存在一些问题，特别是对于状态字节 >= 0xF0 的 MIDI 消息（如 SysEx 消息）。可以使用 MMJ 作为替代的 MIDI 子系统。
• 使用 MMJ 时，需要下载 mmj.jar 和 libmmj.jnilib，并将它们添加到 MidiBus 的 library 子目录中。同时，需要禁用时间戳，通过调用 mybus.sendTimestamp(false) 来实现。

通过以上步骤，用户可以顺利安装并使用 MidiBus 库，进行 MIDI 数据的输入输出操作。