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 compatível com Bluetooth de baixa energia (BLE)
- Cabos USB
- Adaptador On-The-Go (OTG) USB para converter um USB-A fêmea em micro USB ou USB-C masculino
- Dispositivo com Android 6.0 Marshmallow ou versão mais recente
- Opcional: computador desktop
Vários teclados MIDI são compatíveis com USB e BLE-MIDI. Assim, você pode fazer seus testes com apenas um teclado. Por exemplo, Akai LPK25 Wireless (link em inglês) e o Korg Microkey Air (em inglês).
Apps
Vários apps são usados por esse procedimento de teste. Os apps estão disponíveis em código-fonte no projeto GitHub android-midisuite, e pelo Google PlayTM nos links da tabela a seguir.
| Código-fonte | Google PlayTM | Descrição |
|---|---|---|
| MidiScope ou MidiScope (em inglês) | Escopo MIDI | exibe mensagens MIDI na tela. |
| Teclado MIDI | Teclado MIDI | envia mensagens MIDI pressionando um teclado de música na tela |
| MidiSynthExample ou
MidiSynth |
MIDI Synth Ex (link em inglês) | sintetizador MIDI simples que usa osciladores de dente de serra |
| MidiBtlePairing (em inglês) | Conexão MIDI BLE | pareia um dispositivo Android com um periférico BLE |
| MidiTools (link 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 PlayTM, primeiro crie o app usando o Android.mk fornecido. Em seguida, instale o app usando 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 de periférico USB
- Na estação de trabalho, digite:
cd THIS_FOLDERadb install -r MidiScope.apk
Testes de sintetizador virtuais
Uma porta de entrada MIDI só pode ter 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 consegue se conectar ao uma porta de entrada e tente fechar os outros aplicativos.
Hardware necessário: dispositivo Android em teste
Conexão simples
Apps necessários: MidiKeyboard, MidiSynthExample
Testa a enumeração do dispositivo, os dispositivos virtuais, as conexões de porta e a mensagem. enviar.
- Ajuste o volume do dispositivo Android para aproximadamente metade.
- Deixe o smartphone no modo paisagem.
- Inicie o app MidiKeyboard.
- Selecione SynthExample no menu de carregamento.
- Teclas de reprodução. Você ouvirá as notas sendo tocadas no app SynthExample.
- Saia do aplicativo pressionando o botão Voltar para que a porta seja fechadas.
Teste de USB: modo host
Hardware necessário: teclado USB MIDI, cabo USB, adaptador OTG
Repita esses testes várias vezes. Percebemos que a pilha USB falhava muito em alguns prototipar dispositivos se eles estivessem conectados e desconectados algumas vezes.
O teclado já está conectado
Apps necessários: MidiSynthExample ou MidiScope
Testa o USB MIDI no modo host.
- Ajuste o volume do dispositivo Android para aproximadamente metade.
- Conecte o teclado USB usando o adaptador OTG.
- Inicie o app SynthExample ou MidiScope.
- No menu, selecione o teclado USB. A marca vai aparecer.
- Toque as notas no teclado. Se você executou o SynthExample, ouvirá notas sendo reproduzidos no telefone. Se você executou o MidiScope, verá NoteOn e NoteOff na tela.
- Desconecte o teclado. O menu Remetente do Synth deve exibir - - - - -.
- Saia do aplicativo pressionando o botão Voltar.
Conecte o teclado USB
Apps necessários: MidiSynthExample ou MidiScope
Testa o USB MIDI no modo host.
- Ajuste o volume do dispositivo Android para aproximadamente metade.
- Verifique se não há um teclado USB MIDI conectado.
- Abra o app SynthExample.
- No meio, ao lado de Remetente para Synth, procure no menu. Você não verá o USB teclado listado.
- Conecte o teclado USB usando o adaptador OTG.
- No meio, ao lado de Remetente do Synth, selecione o teclado USB. Ele vai mostrar da marca.
- Toque as notas no teclado. Você ouvirá as notas sendo tocadas no telefone.
- No meio, ao lado de Remetente para Synth, selecione - - - - -.
- Toque as notas no teclado. Você não ouvirá nada.
- No meio, ao lado de Remetente do Synth, selecione o teclado USB. Ele vai mostrar da marca.
- Toque as notas no teclado. Você ouvirá as notas sendo tocadas no telefone.
- Desconecte o sintetizador. O menu Remetente do Synth deve exibir - - - - -.
- Saia do aplicativo pressionando o botão Voltar.
Teste de USB: modo periférico
Hardware necessário: cabo USB, adaptador OTG
Android para Android
Apps necessários: MidiTeclado no dispositivo Android em teste, MidiScope em outro dispositivo Android.
Usar dispositivos Android como um controle periférico para outro dispositivo Android. Para ajudar a testar neste modo, use outro dispositivo Android executado no modo host. Observe que você pode modificar o teste para funcionar com um computador desktop que execute a Estação de Trabalho de Áudio Digital (DAW) de software, como 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 dispositivo B que opera no modo host.
- No dispositivo Android A:
- Arraste o dedo para baixo a partir da parte superior da tela.
- Selecione o ícone USB para carregamento.
- Selecione MIDI.
- Inicie o app MidiKeyboard.
- Selecione Android USB Peripheral Port no menu Receptor para chaves na parte de cima.
- No dispositivo Android B:
- Inicie o app MidiScope.
- Selecione o outro dispositivo Android como origem.
- No dispositivo Android A:
- Toque as notas no teclado e procure NoteOn e NoteOff no dispositivo Android B.
Teste BLE
Hardware necessário: teclado MIDI compatível com BLE
Noções básicas de pareamento e reprodução
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 próximo à parte de trás para que para que ele se abra. O botão liga/desliga do C.24 pisca em azul durante o 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 os periféricos vão aparecer listados. Se estiver usando uma C.24, a luz vai ficar verde C.24 para indicar o modo de pareamento.
- Saia do app pressionando o botão Home, não o botão Voltar.
- Inicie o app SynthExample.
- Selecione o teclado BLE como remetente no menu.
- Você poderá pressionar as teclas no teclado BLE e ouvir as anotações Android