MIDI

MIDI(乐器数字接口)是用于将计算机与乐器、舞台灯光和其他时间型媒体相互连接的标准协议。

严格来说,MIDI 与音频无关。但是,由于 MIDI 通常用于音乐处理,因此将本文安排在了音频部分。

传输

首版 MIDI 1.0 中指定的物理传输层是一个具有 5 针 DIN 连接器的电流回路。

自 MIDI 1.0 推出以来,还定义了其他传输协议,包括通过 USB 传输 MIDI 以及通过蓝牙低功耗 (BLE) 传输 MIDI 的提议草案。

在 Android 上使用 MIDI

Android 3.1 及更高版本支持 USB On-The-Go,允许 Android 设备充当 USB 主机来驱动 USB 外设。在 Android 3.1 中引入的 USB 主机模式 API 允许开发者在应用级别通过 USB 实现 MIDI,但直到最近才推出了针对 MIDI 的内置平台 API。

从 Android 6.0 (Marshmallow) 版本开始,设备制造商可以在平台中启用可选的 MIDI 支持。Android 直接支持 USB、BLE 草案和虚拟(应用间)传输。Android 通过外部适配器间接支持 MIDI 1.0。

有关使用新 MIDI API 进行应用编程的详细信息,请参阅 android.media.midi 软件包。

本文的其余部分讨论了 Android 设备制造商如何在平台中启用 MIDI 支持。

启用传输

该实现以 ALSA 为基础来实现 USB 主机模式和 USB 外设模式传输。ALSA 不用于 BLE 和虚拟传输。

USB 主机模式

要为 USB 主机模式启用 MIDI,请首先在总体上支持 USB 主机模式,然后在内核配置中启用 CONFIG_SND_RAWMIDICONFIG_SND_USB_MIDI。请参阅 Android 内核配置

通过 USB 传输 MIDI 由 USB Implementers Forum, Inc 发布的关于 MIDI 设备的通用串行总线设备类定义 1.0 版(1999 年 11 月 1 日)标准正式给出定义。

USB 外设模式

要为 USB 外设模式启用 MIDI,您可能需要将补丁程序应用到 Linux 内核,才能将 drivers/usb/gadget/f_midi.c 集成到 USB 小工具驱动程序中。在撰写本文时,这些补丁程序可用于 Linux 内核版本 3.10。这些补丁程序尚未针对 ConfigFs(适用于 USB 小工具驱动程序的新架构)进行更新,也未合并到上游 kernel.org

补丁程序按位于项目 kernel/common 分支 android-3.10 的内核树的提交顺序显示:

  1. https://android-review.googlesource.com/#/c/127450/
  2. https://android-review.googlesource.com/#/c/127452/
  3. https://android-review.googlesource.com/#/c/143714/

此外,最终用户还必须在“设置”/“开发者选项”/“网络”/“选择 USB 配置”对话框中勾选 MIDI 框,或者在连接到 USB 主机时从屏幕顶部向下拉,选择条目“USB 的用途…”,然后选择 MIDI

BLE

只要设备支持 BLE,通过 BLE 传输 MIDI 的功能就始终处于启用状态。由于此传输协议还处于草案阶段,因此可能会发生变化。

虚拟(应用间)

虚拟(应用间)传输始终处于启用状态。

声明功能

应用可以使用 android.software.midi 功能来检查设备是否支持 MIDI。

要声明 MIDI 支持,请将以下行添加到您的 device.mk

PRODUCT_COPY_FILES += \
frameworks/native/data/etc/android.software.midi.xml:system/etc/permissions/android.software.midi.xml

要了解声明相关功能的要求,请参阅 Android 兼容性定义文档 (CDD)

在主机模式下进行调试

在 USB 主机模式下,无法通过 USB 进行 Android 调试桥 (adb) 调试。请参阅 Android 调试桥无线用法部分,了解备选方案。