La interfaz digital para instrumentos musicales (MIDI) es un protocolo estándar para interconectar computadoras con instrumentos musicales, iluminación escénica y otros medios orientados al tiempo.
A partir de Android 13, se admite MIDI 2.0 en el transporte USB. MIDI 2.0 es un estándar MIDI más reciente que se definió en 2020. Este protocolo agrega funciones como la comunicación bidireccional, una resolución más alta y el intercambio de propiedades. MIDI 2.0 a través del modo host USB siempre está habilitado cuando la compatibilidad con MIDI está habilitada en la plataforma.
Estrictamente hablando, MIDI no está relacionado con el audio. Sin embargo, como MIDI se usa con frecuencia con música, este artículo se encuentra en la sección de audio.
MIDI para NDK
Con Android 10, es más fácil portar apps de audio profesionales con MIDI en la plataforma de Android.
AMidi es una API de NDK que brinda a los desarrolladores de apps la capacidad de enviar y recibir datos MIDI con código C/C++.
Por lo general, las apps MIDI de Android usan la API de
midi para comunicarse con el servicio MIDI de Android. Las apps MIDI dependen principalmente de la clase
MidiManager para descubrir, abrir y cerrar uno o más objetos
MidiDevice, y pasar datos hacia y desde cada dispositivo a través de los puertos de entrada y salida MIDI del dispositivo.
Transporte
La capa de transporte física especificada en el MIDI 1.0 original es un bucle de corriente con conector DIN de 5 pines.
A partir de MIDI 1.0, se definieron transportes adicionales, incluidos MIDI por USB y MIDI por Bluetooth de bajo consumo (BLE).
MIDI para Android
Android admite USB On-The-Go, que permite que un dispositivo Android funcione como host USB para controlar periféricos USB. Las APIs de modo de host USB permiten a los desarrolladores implementar MIDI mediante USB a nivel de la aplicación, pero hasta hace poco no ha habido APIs de plataforma integradas para MIDI.
A partir de la versión de Android 6.0 (Marshmallow), los fabricantes de dispositivos pueden habilitar la compatibilidad opcional con MIDI en la plataforma. Android admite directamente los transportes USB, BLE y virtuales (entre apps). Android admite MIDI 1.0 a través de un adaptador externo.
Para obtener detalles sobre la programación de aplicaciones con las APIs de MIDI, consulta el paquete android.media.midi.
En el resto de este artículo, se explica cómo un fabricante de dispositivos Android puede habilitar la compatibilidad con MIDI en la plataforma.
Habilita los transportes MIDI 1.0
La implementación de MIDI 1.0 depende de ALSA para el transporte del modo de host USB y del modo periférico USB. ALSA no se usa para BLE ni transportes virtuales.
Modo host USB
Si quieres habilitar MIDI para el modo de host USB, primero debes admitir el modo de host USB en general y, luego, habilitar CONFIG_SND_RAWMIDI y CONFIG_SND_USB_MIDI en la configuración del kernel. Consulta Configuración del kernel de Android.
El transporte MIDI a través de USB se define formalmente en el estándar Definición de clase de dispositivo de bus universal en serie para dispositivos MIDI, versión 1.0, 1 de noviembre de 1999 publicado por USB Implementers Forum, Inc.
Modo periférico USB
Si quieres habilitar MIDI para el modo periférico USB, es posible que debas aplicar parches a tu kernel de Linux para integrar drivers/usb/gadget/f_midi.c en el controlador de gadgets USB. Estos parches están disponibles para la versión 3.10 del kernel de Linux. Estos parches aún no se actualizaron para ConfigFs (una nueva arquitectura para los controladores de dispositivos USB) ni se fusionaron en kernel.org upstream.
Los parches se muestran en orden de confirmación para el árbol del kernel en la rama android-3.10 del proyecto kernel/common:
- https://android-review.googlesource.com/#/c/127450/
- https://android-review.googlesource.com/#/c/127452/
- https://android-review.googlesource.com/#/c/143714/
También debes realizar cualquiera de las siguientes acciones:
- Ve a Configuración > Opciones para desarrolladores > Red y marca la casilla de MIDI en el diálogo Seleccionar configuración de USB.
- Mientras estás conectado al host USB, desliza el dedo hacia abajo desde la parte superior de la pantalla, selecciona la entrada USB for y, luego, MIDI.
BLE
MIDI por BLE siempre está habilitado, siempre que el dispositivo sea compatible con BLE.
Virtual (entre apps)
El transporte virtual (entre apps) siempre está habilitado.
Cómo reclamar la función
Las apps pueden detectar la presencia de compatibilidad con MIDI con la función android.software.midi.
Para reclamar compatibilidad con MIDI, agrega esta línea a tu device.mk:
PRODUCT_COPY_FILES += \ frameworks/native/data/etc/android.software.midi.xml:system/etc/permissions/android.software. midi.xml
Consulta el Documento de definición de compatibilidad de Android (CDD) para obtener información sobre los requisitos para reclamar la función.
Cómo depurar en modo host
Mientras el dispositivo está en modo de host USB, la depuración de Android Debug Bridge (adb) por USB no está disponible. Para obtener una alternativa, consulta la sección Uso inalámbrico de Android Debug Bridge.