Google 致力于为黑人社区推动种族平等。查看具体举措

MIDI

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

严格来说,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 实现以 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 调试桥的无线用法部分,了解备选方案。