Pengujian ini dapat digunakan untuk memvalidasi fitur MIDI di perangkat Android. Keberhasilan eksekusi pengujian ini adalah prasyarat untuk mengklaim fitur MIDI.
Persiapan
Hardware
Hardware berikut diperlukan untuk pengujian.
- Keyboard MIDI dengan konektor USB
- Keyboard MIDI dengan dukungan Bluetooth Hemat Energi (BLE)
- Kabel USB
- Adaptor USB On-The-Go (OTG) untuk mengonversi USB-A betina menjadi micro-USB atau USB-C jantan
- Perangkat Android yang menjalankan rilis Android 6.0 Marshmallow atau yang lebih baru
- Opsional: komputer desktop
Beberapa keyboard MIDI mendukung USB dan BLE-MIDI, sehingga Anda dapat melakukan pengujian dengan hanya satu keyboard. Contohnya adalah Akai LPK25 Wireless dan Korg Microkey Air.
Aplikasi
Beberapa aplikasi digunakan oleh prosedur pengujian ini. Aplikasi ini tersedia dalam kode sumber di project GitHub android-midisuite, dan melalui Google Play™ di link dalam tabel berikut.
| Kode sumber | Google Play™ | Deskripsi |
|---|---|---|
| MidiScope atau MidiScope | Cakupan MIDI | menampilkan pesan MIDI di layar |
| MidiKeyboard | Keyboard MIDI | mengirim pesan MIDI dengan menekan keyboard musik di layar |
| MidiSynthExample atau
MidiSynth |
MIDI Synth Ex | synthesizer MIDI sederhana yang menggunakan osilator gigi gergaji |
| MidiBtlePairing | MIDI BLE Connect | menyambungkan perangkat Android dengan periferal BLE |
| MidiTools | dependensi library aplikasi di atas |
Jika Anda memilih untuk bekerja dari kode sumber, bukan menginstal melalui Google Play™, bangun aplikasi terlebih dahulu menggunakan Android.mk yang disediakan. Kemudian, instal aplikasi menggunakan Android Debug Bridge (ADB). Misalnya, untuk menginstal aplikasi MidiScope:
- Gunakan workstation dengan ADB yang terinstal.
- Hubungkan kabel USB dari workstation ke perangkat Android.
- Anda mungkin perlu mengizinkan koneksi USB di perangkat Android; lihat Mode periferal USB
- Di workstation, masukkan:
cd THIS_FOLDERadb install -r MidiScope.apk
Pengujian virtual synth
Perhatikan bahwa port input MIDI hanya dapat memiliki satu koneksi. Jadi, jika aplikasi lain sudah menggunakan port input, port tersebut tidak akan tersedia. Jika Anda tidak dapat terhubung ke port input, coba tutup aplikasi lain.
Hardware yang diperlukan: Perangkat Android yang sedang diuji
Koneksi sederhana
Aplikasi yang diperlukan: MidiKeyboard, MidiSynthExample
Pengujian ini menguji enumerasi perangkat, perangkat virtual, koneksi port, dan pengiriman pesan.
- Sesuaikan volume di perangkat Android menjadi sekitar setengah.
- Atur orientasi ponsel dalam mode lanskap.
- Luncurkan aplikasi MidiKeyboard.
- Pilih SynthExample dari menu indikator lingkaran berputar.
- Memutar kunci. Anda akan mendengar nada yang diputar di aplikasi SynthExample.
- Keluar dari aplikasi dengan menekan tombol Kembali sehingga port akan ditutup.
Pengujian USB: mode host
Hardware yang diperlukan: Keyboard MIDI USB, kabel USB, adaptor OTG
Ulangi pengujian ini beberapa kali. Kami telah melihat stack USB mengalami error berat di beberapa perangkat prototipe jika perangkat dicolokkan dan dicabut beberapa kali.
Keyboard sudah dicolokkan
Aplikasi yang diperlukan: MidiSynthExample atau MidiScope
Pengujian ini menguji USB MIDI dalam mode host.
- Sesuaikan volume di perangkat Android menjadi sekitar setengah.
- Colokkan keyboard USB menggunakan adaptor OTG.
- Luncurkan aplikasi SynthExample atau aplikasi MidiScope.
- Dari menu, pilih keyboard USB. Tindakan ini akan menampilkan merek.
- Memutar nada di keyboard. Jika menjalankan SynthExample, Anda akan mendengar not yang diputar di ponsel. Jika menjalankan MidiScope, Anda akan melihat pesan NoteOn dan NoteOff di layar.
- Cabut kabel keyboard. Menu Pengirim untuk Synthesizer akan menampilkan - - - - -.
- Keluar dari aplikasi dengan menekan tombol Kembali.
Keyboard USB hot-plug
Aplikasi yang diperlukan: MidiSynthExample atau MidiScope
Pengujian ini menguji USB MIDI dalam mode host.
- Sesuaikan volume di perangkat Android menjadi sekitar setengah.
- Pastikan tidak ada keyboard MIDI USB yang dicolokkan.
- Luncurkan aplikasi SynthExample.
- Di bagian tengah, di samping Sender for Synth, lihat di menu. Anda tidak akan melihat keyboard USB tercantum.
- Colokkan keyboard USB menggunakan adaptor OTG.
- Di bagian tengah, di samping Sender for Synth, pilih keyboard USB. Tindakan ini akan menampilkan merek.
- Memutar nada di keyboard. Anda akan mendengar nada yang diputar di ponsel.
- Di bagian tengah, di samping Pengirim untuk Sintetizer, pilih - - - - -.
- Memutar nada di keyboard. Anda tidak akan mendengar apa pun.
- Di bagian tengah, di samping Sender for Synth, pilih keyboard USB. Tindakan ini akan menampilkan merek.
- Memutar nada di keyboard. Anda akan mendengar nada yang diputar di ponsel.
- Cabut synthesizer. Menu Pengirim untuk Synthesizer akan menampilkan - - - - -.
- Keluar dari aplikasi dengan menekan tombol Kembali.
Pengujian USB: mode periferal
Hardware yang diperlukan: Kabel USB, adaptor OTG
Android ke Android
Aplikasi yang diperlukan: MidiKeyboard di perangkat Android yang sedang diuji, MidiScope di perangkat Android lain.
Menggunakan perangkat Android sebagai pengontrol periferal untuk perangkat Android lain. Untuk membantu menguji mode ini, gunakan perangkat Android lain yang berjalan dalam mode host. Perhatikan bahwa Anda dapat mengubah pengujian agar berfungsi dengan komputer desktop yang menjalankan software Digital Audio Workstation (DAW) seperti GarageBand.
- Hubungkan kabel USB ke perangkat Android yang sedang diuji (perangkat Android A).
- Gunakan adaptor OTG untuk menghubungkan ujung kabel lainnya ke perangkat Android kedua B yang beroperasi dalam mode host.
- Di perangkat Android A:
- Tarik jari ke bawah dari bagian atas layar.
- Pilih ikon USB untuk Pengisian Daya.
- Pilih MIDI.
- Luncurkan aplikasi MidiKeyboard.
- Pilih Android USB Peripheral Port dari menu Receiver for Keys di bagian atas.
- Di perangkat Android B:
- Luncurkan aplikasi MidiScope.
- Pilih perangkat Android lainnya sebagai sumber.
- Di perangkat Android A:
- Putar nada di keyboard dan cari NoteOn dan NoteOff di perangkat Android B.
Pengujian BLE
Hardware yang diperlukan: Keyboard MIDI yang mendukung BLE
Penyambungan dan pemutaran dasar
Aplikasi yang diperlukan: MidiBtlePairing, MidiSynthExample
Menguji keyboard yang terhubung ke Android melalui BLE.
- Mulai ulang perangkat Android.
- Nyalakan keyboard BLE.
(Keyboard Miselu C.24 diaktifkan dengan menekan tombol di dekat bagian belakang sehingga keyboard terbuka. Tombol daya di C.24 berkedip biru saat dalam mode penyambungan.) - Luncurkan aplikasi MidiBtlePairing. Aplikasi ini memiliki ikon MIDI+BTLE.
- Tekan tombol Pemindaian Bluetooth.
- Pilih periferal BLE yang diinginkan.
- Aplikasi akan kembali ke halaman utama, dan Anda akan melihat periferal tercantum. Jika menggunakan C.24, Anda akan melihat bahwa lampu akan berubah menjadi hijau di C.24 untuk menunjukkan mode tersambung.
- Keluar dari aplikasi dengan menekan tombol Home, bukan tombol Back.
- Luncurkan aplikasi SynthExample.
- Pilih keyboard BLE sebagai pengirim dari menu.
- Anda akan dapat menekan tombol di keyboard BLE dan mendengar catatan di Android.