MIDI

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

从 Android 13 开始，USB 传输添加了对 MIDI 2.0 的支持。MIDI 2.0 是 2020 年定义的较新的 MIDI 标准。此协议增加了双向通信、更高的分辨率和属性交换等功能。当在平台上启用 MIDI 支持时，将始终启用通过 USB 主机模式运行 MIDI 2.0。

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

在 NDK 上使用 MIDI

Android 10 可轻松地将使用 MIDI 的专业音频应用移植到 Android 平台。

AMidi 是一种 NDK API。借助该 API，应用开发者可以使用 C/C++ 代码发送和接收 MIDI 数据。

Android MIDI 应用通常使用 midi API 与 Android MIDI 服务通信。MIDI 应用主要依赖于 MidiManager 类发现、打开和关闭一个或多个 MidiDevice 对象，并通过设备的 MIDI 输入和输出端口与各个设备相互传递数据。

传输

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

自 MIDI 1.0 发布以来，我们还定义了其他传输功能，包括通过 USB 传输 MIDI 以及通过蓝牙低功耗 (BLE) 传输 MIDI。

在 Android 上使用 MIDI

Android 支持 USB On-The-Go，允许 Android 设备充当 USB 主机以驱动 USB 外围设备。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 支持。

启用 MIDI 1.0 传输

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

USB 主机模式

如需为 USB 主机模式启用 MIDI，请首先在总体上支持 USB 主机模式，然后在内核配置中启用 CONFIG_SND_RAWMIDI 和 CONFIG_SND_USB_MIDI。请参阅 Android 内核配置。

通过 USB 传输 MIDI 是在 USB 开发者论坛 (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 的内核树的提交顺序显示：

您还需要执行以下任一操作：

转到“设置”>“开发者选项”>“网络”，然后在“选择 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 调试桥的无线用法部分，了解备选方案。