Esses testes podem ser usados para validar o recurso MIDI em dispositivos Android. A execução bem sucedida destes testes é um pré-requisito para reivindicar o recurso MIDI .
Preparação
Hardware
O seguinte hardware é necessário para os testes.
- Teclado MIDI com conector USB
- Teclado MIDI com suporte para Bluetooth Low Energy (BLE)
- Cabos USB
- Adaptador USB On-The-Go (OTG) para converter um USB-A fêmea em micro-USB ou USB-C macho
- Dispositivo Android com Android 6.0 Marshmallow ou versão posterior
- Opcional: computador desktop
Vários teclados MIDI suportam USB e BLE-MIDI, então você pode fazer seus testes com apenas um teclado. Exemplos são o Akai LPK25 Wireless e o Korg Microkey Air .
Aplicativos
Vários aplicativos são usados por este procedimento de teste. Os aplicativos estão disponíveis em código-fonte no projeto GitHub android-midisuite , e via Google Play ™ nos links da tabela a seguir.
| Código fonte | Google Play™ | Descrição |
|---|---|---|
| MidiScope ou MidiScope | Escopo MIDI | exibe mensagens MIDI na tela |
| Teclado Midi | Teclado MIDI | envia mensagens MIDI pressionando um teclado musical na tela |
| MidiSynthExemplo ou MidiSintet | Sintetizador MIDI Ex | sintetizador MIDI simples que usa osciladores dente de serra |
| Emparelhamento MidiBtle | Conexão MIDI BLE | emparelha um dispositivo Android com um periférico BLE |
| Ferramentas Midi | dependência de biblioteca dos aplicativos acima |
Se você optar por trabalhar a partir do código-fonte em vez de instalar via Google Play ™, primeiro crie o aplicativo usando o Android.mk fornecido. Em seguida, instale o aplicativo usando o Android Debug Bridge (ADB). Por exemplo, para instalar o aplicativo MidiScope :
- Use uma estação de trabalho com ADB instalado.
- Conecte um cabo USB da estação de trabalho ao dispositivo Android.
- Pode ser necessário permitir a conexão USB no dispositivo Android; veja modo periférico USB
- Na estação de trabalho, digite:
cd THIS_FOLDERadb install -r MidiScope.apk
Testes de sintetizador virtual
Observe que uma porta de entrada MIDI pode ter apenas uma conexão. Portanto, se outro aplicativo já estiver usando uma porta de entrada, essa porta não estará disponível. Se você não conseguir se conectar a uma porta de entrada, tente fechar outros aplicativos.
Hardware necessário: dispositivo Android em teste
Conexão simples
Aplicativos necessários: MidiKeyboard , MidiSynthExample
Isso testa a enumeração de dispositivos, dispositivos virtuais, conexões de porta e envio de mensagens.
- Ajuste o volume no dispositivo Android até a metade.
- Oriente o telefone no modo paisagem.
- Inicie o aplicativo MidiKeyboard .
- Selecione SynthExample no menu giratório.
- Toque as teclas. Você deverá ouvir notas sendo tocadas no aplicativo SynthExample .
- Saia do aplicativo pressionando o botão Voltar para que a porta seja fechada.
Teste USB: modo host
Hardware necessário: teclado USB MIDI, cabo USB, adaptador OTG
Repita esses testes várias vezes. Vimos a pilha USB travar fortemente em alguns dispositivos protótipos se os dispositivos fossem conectados e desconectados algumas vezes.
Teclado já conectado
Aplicativos necessários: MidiSynthExample ou MidiScope
Isso testa USB MIDI no modo host.
- Ajuste o volume no dispositivo Android até a metade.
- Conecte o teclado USB usando o adaptador OTG.
- Inicie o aplicativo SynthExample ou o aplicativo MidiScope .
- No menu selecione o teclado USB. Ele exibirá a marca.
- Toque notas no teclado. Se você executou SynthExample , deverá ouvir notas sendo tocadas no telefone. Se você executou o MidiScope , deverá ver as mensagens NoteOn e NoteOff na tela.
- Desconecte o teclado. O menu Sender for Synth deve exibir - - - - - .
- Saia do aplicativo pressionando o botão Voltar .
Teclado USB hot-plug
Aplicativos necessários: MidiSynthExample ou MidiScope
Isso testa USB MIDI no modo host.
- Ajuste o volume no dispositivo Android até a metade.
- Certifique-se de que não haja um teclado MIDI USB conectado.
- Inicie o aplicativo SynthExample .
- No meio, próximo a Sender for Synth , procure no menu. Você não deverá ver o teclado USB listado.
- Conecte o teclado USB usando o adaptador OTG.
- No meio, próximo a Sender for Synth , selecione o teclado USB. Ele exibirá a marca.
- Toque notas no teclado. Você deverá ouvir notas sendo tocadas no telefone.
- No meio, próximo a Sender for Synth , selecione - - - - - .
- Toque notas no teclado. Você não deveria ouvir nada.
- No meio, próximo a Sender for Synth , selecione o teclado USB. Ele exibirá a marca.
- Toque notas no teclado. Você deverá ouvir notas sendo tocadas no telefone.
- Desligue o sintetizador. O menu Sender for Synth deve exibir - - - - - .
- Saia do aplicativo pressionando o botão Voltar .
Teste USB: modo periférico
Hardware necessário: cabo USB, adaptador OTG
Android para Android
Aplicativos necessários: MidiKeyboard no dispositivo Android em teste, MidiScope em outro dispositivo Android.
Use dispositivos Android como controlador periférico para outro dispositivo Android. Para ajudar a testar esse modo, use outro dispositivo Android em execução no modo host. Observe que você pode modificar o teste para funcionar com um computador desktop executando software Digital Audio Workstation (DAW), como o GarageBand.
- Conecte o cabo USB ao dispositivo Android em teste (dispositivo Android A ).
- Use um adaptador OTG para conectar a outra extremidade do cabo a um segundo dispositivo Android B que opera no modo host.
- No dispositivo Android A:
- Arraste o dedo para baixo da parte superior da tela.
- Selecione o ícone USB para carregamento .
- Selecione MIDI .
- Inicie o aplicativo MidiKeyboard .
- Selecione Porta periférica USB Android no menu Receptor para chaves na parte superior.
- No dispositivo Android B:
- Inicie o aplicativo MidiScope .
- Selecione o outro dispositivo Android como fonte.
- No dispositivo Android A:
- Toque notas no teclado e procure NoteOn e NoteOff no dispositivo Android B.
Teste BLE
Hardware necessário: teclado MIDI com suporte para BLE
Emparelhamento e jogo básicos
Aplicativos necessários: MidiBtlePairing , MidiSynthExample
Teste um teclado conectado ao Android via BLE.
- Reinicie o dispositivo Android.
- Ligue o teclado BLE.
(O teclado Miselu C.24 é ligado pressionando o botão próximo à parte traseira para que ele se abra. O botão liga / desliga no C.24 pulsa em azul quando está no modo de emparelhamento.) - Inicie o aplicativo MidiBtlePairing . Possui um ícone MIDI + BTLE .
- Pressione o botão Pesquisa Bluetooth .
- Selecione o periférico BLE desejado.
- O aplicativo deverá retornar à página principal e você deverá ver o periférico listado. Se você estiver usando um C.24, notará que a luz deve ficar verde no C.24 para indicar o modo emparelhado.
- Saia do aplicativo pressionando o botão Home , não o botão Voltar .
- Inicie o aplicativo SynthExample.
- Selecione o teclado BLE como remetente no menu.
- Você deve conseguir pressionar teclas no teclado BLE e ouvir notas no Android.