首页
/ MidiBus 项目技术文档

MidiBus 项目技术文档

2024-12-20 01:33:10作者:余洋婵Anita

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.jarlibmmj.jnilib,并将它们添加到 MidiBus 的 library 子目录中。同时,需要禁用时间戳,通过调用 mybus.sendTimestamp(false) 来实现。

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

登录后查看全文
热门项目推荐