Esses testes podem ser usados para validar o recurso MIDI em dispositivos Android. A execução desses testes é um pré-requisito para reivindicar o recurso MIDI.
Preparação
Hardware
O hardware a seguir é necessário para os testes.
- Teclado MIDI com conector USB
- Teclado MIDI com suporte a Bluetooth de baixa energia (BLE)
- Cabos USB
- Adaptador USB On-The-Go (OTG) para converter uma USB-A fêmea em micro-USB macho ou USB-C
- Dispositivo Android com Android 6.0 Marshmallow ou versão mais recente
- Opcional: computador
Vários teclados MIDI oferecem suporte a USB e BLE-MIDI, para que você possa fazer os testes com apenas um teclado. Exemplos são o Akai LPK25 Wireless e o Korg Microkey Air.
Apps
Vários apps são usados por este procedimento de teste. Os apps estão disponíveis no código-fonte do projeto do GitHub android-midisuite e no Google Play™ nos links da tabela a seguir.
| Código-fonte | Google Play™ | Descrição |
|---|---|---|
| MidiScope ou MidiScope | MIDI Scope (link em inglês) | mostra mensagens MIDI na tela |
| MidiKeyboard | Teclado MIDI | envia mensagens MIDI ao pressionar um teclado musical na tela |
| MidiSynthExample ou
MidiSynth |
Exemplo de sintetizador MIDI | sintetizador MIDI simples que usa osciladores de dente-de-serra; |
| MidiBtlePairing | MIDI BLE Connect | pareia um dispositivo Android com um periférico BLE; |
| MidiTools (em inglês) | dependência de biblioteca dos apps acima |
Se você optar por trabalhar com o código-fonte em vez de instalar pelo Google Play™, crie o app usando o Android.mk fornecido. Em seguida, instale o app usando o Android Debug Bridge (adb). Por exemplo, para instalar o app MidiScope:
- Use uma estação de trabalho com o ADB instalado.
- Conecte um cabo USB da estação de trabalho ao dispositivo Android.
- Talvez seja necessário permitir a conexão USB no dispositivo Android. Consulte Modo periférico USB.
- Na estação de trabalho, digite:
cdTHIS_FOLDER adb install -r MidiScope.apk
Testes de sintetizador virtual
Uma porta de entrada MIDI pode ter apenas uma conexão. Portanto, se outro app já estiver usando uma porta de entrada, ela não estará disponível. Se não for possível se conectar a uma porta de entrada, tente fechar outros apps.
Hardware necessário: dispositivo Android em teste
Conexão simples
Apps necessários: MidiKeyboard, MidiSynthExample
Ele 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 smartphone no modo paisagem.
- Inicie o app MidiKeyboard.
- Selecione SynthExample no menu de carregamento.
- Teclas de reprodução. Você vai ouvir as notas sendo tocadas no app SynthExample.
- Saia do aplicativo pressionando o botão Voltar para que a porta seja fechada.
Teste USB: modo de host
Hardware necessário: teclado MIDI USB, cabo USB, adaptador OTG
Repita esses testes várias vezes. Notamos que a pilha USB falhava em alguns dispositivos de protótipo se eles fossem conectados e desconectados algumas vezes.
Teclado já conectado
Apps necessários: MidiSynthExample ou MidiScope
Ele testa o USB MIDI no modo host.
- Ajuste o volume no dispositivo Android até a metade.
- Conecte o teclado USB usando o adaptador OTG.
- Inicie o app SynthExample ou o app MidiScope.
- No menu, selecione o teclado USB. A marca vai aparecer.
- Tocar notas no teclado. Se você executou SynthExample, vai ouvir as notas sendo tocadas no smartphone. Se você executou o MidiScope, as mensagens NoteOn e NoteOff vão aparecer na tela.
- Desconecte o teclado. O menu Sender for Synth vai mostrar - - - - -.
- Saia do aplicativo pressionando o botão Voltar.
Teclado USB com conexão plug-and-play
Apps necessários: MidiSynthExample ou MidiScope
Ele testa o USB MIDI no modo host.
- Ajuste o volume no dispositivo Android até a metade.
- Verifique se não há um teclado MIDI USB conectado.
- Inicie o app SynthExample.
- No meio, ao lado de Sender for Synth, procure no menu. O teclado USB não deve aparecer na lista.
- Conecte o teclado USB usando o adaptador OTG.
- Na parte de baixo, ao lado de Sender for Synth, selecione o teclado USB. Ele vai mostrar a marca.
- Tocar notas no teclado. Você vai ouvir as notas sendo tocadas no smartphone.
- Na parte de baixo, ao lado de Sender for Synth, selecione - - - - -.
- Tocar notas no teclado. Você não vai ouvir nada.
- Na parte de baixo, ao lado de Sender for Synth, selecione o teclado USB. Ele vai mostrar a marca.
- Tocar notas no teclado. Você vai ouvir as notas sendo tocadas no smartphone.
- Desconecte o sintetizador. O menu Sender for Synth vai mostrar - - - - -.
- Saia do aplicativo pressionando o botão Voltar.
Teste USB: modo periférico
Hardware necessário: cabo USB, adaptador OTG
Android para Android
Apps necessários: MidiKeyboard no dispositivo Android em teste, MidiScope em outro dispositivo Android.
Use dispositivos Android como um controlador periférico para outro dispositivo Android. Para ajudar a testar esse modo, use outro dispositivo Android em execução no modo host. É possível modificar o teste para funcionar com um computador de mesa com um software de Estação de Trabalho de Áudio Digital (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 opere no modo host.
- No dispositivo Android A:
- Arraste o dedo para baixo a partir da parte de cima da tela.
- Selecione o ícone USB para carregamento.
- Selecione MIDI.
- Inicie o app MidiKeyboard.
- Selecione Android USB Peripheral Port no menu Receiver for Keys na parte de cima.
- No dispositivo Android B:
- Inicie o app MidiScope.
- Selecione o outro dispositivo Android como a 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 a BLE
Como parear e reproduzir músicas
Apps necessários: MidiBtlePairing, MidiSynthExample
Teste um teclado conectado ao Android por BLE.
- Reinicie o dispositivo Android.
- Ligue o teclado BLE.
(O teclado Miselu C.24 é ligado pressionando o botão perto da parte de trás para que ele abra. O botão de energia no C.24 pisca em azul quando está no modo de pareamento.) - Inicie o app MidiBtlePairing. Ele tem um ícone MIDI+BTLE.
- Pressione o botão Busca por Bluetooth.
- Selecione o periférico BLE desejado.
- O app vai retornar à página principal, e o periférico vai aparecer na lista. Se você estiver usando um C.24, a luz vai ficar verde no C.24 para indicar o modo pareado.
- Saia do app pressionando o botão Início, não o botão Voltar.
- Inicie o app SynthExample.
- Selecione o teclado BLE como o remetente no menu.
- Você poderá pressionar teclas no teclado BLE e ouvir notas no Android.