Tes ini dapat digunakan untuk memvalidasi fitur MIDI pada perangkat Android. Eksekusi yang berhasil dari tes ini merupakan prasyarat untuk mengklaim fitur MIDI .
Persiapan
Perangkat keras
Perangkat keras berikut diperlukan untuk pengujian.
- Keyboard MIDI dengan konektor USB
- Keyboard MIDI dengan dukungan Bluetooth Low Energy (BLE)
- kabel USB
- Adaptor USB On-The-Go (OTG) untuk mengonversi USB-A wanita ke micro-USB atau USB-C male
- Perangkat Android yang menjalankan Android 6.0 Marshmallow atau rilis yang lebih baru
- Opsional: komputer desktop
Beberapa keyboard MIDI mendukung USB dan BLE-MIDI, sehingga Anda dapat melakukan pengujian hanya dengan satu keyboard. Contohnya adalah Akai LPK25 Wireless dan Korg Microkey Air .
Aplikasi
Beberapa aplikasi digunakan oleh prosedur pengujian ini. Aplikasi tersedia dalam kode sumber pada proyek GitHub android-midisuite , dan melalui Google Play ™ pada tautan di tabel berikut.
| Kode sumber | Google Play™ | Keterangan |
|---|---|---|
| MidiScope atau MidiScope | Lingkup MIDI | menampilkan pesan MIDI di layar |
| keyboard midi | Papan Ketik MIDI | mengirim pesan MIDI dengan menekan keyboard musik di layar |
| MidiSynthContoh atau MidiSynth | MIDI Synth Ex | synthesizer MIDI sederhana yang menggunakan osilator gigi gergaji |
| Pasangan MidiBtle | Sambungan MIDI BLE | memasangkan perangkat Android dengan periferal BLE |
| MidiTools | ketergantungan perpustakaan dari aplikasi di atas |
Jika Anda memilih untuk bekerja dari kode sumber daripada menginstal melalui Google Play ™, pertama-tama buat aplikasi menggunakan Android.mk yang disediakan. Kemudian instal aplikasi menggunakan Android Debug Bridge (ADB). Misalnya, untuk menginstal aplikasi MidiScope :
- Gunakan workstation dengan ADB terinstal.
- Hubungkan kabel USB dari workstation ke perangkat Android.
- Anda mungkin perlu mengizinkan koneksi USB pada perangkat Android; lihat mode periferal USB
- Di stasiun kerja, masukkan:
cd THIS_FOLDERadb install -r MidiScope.apk
Tes synth virtual
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.
Perangkat keras yang dibutuhkan: Perangkat Android sedang diuji
Koneksi sederhana
Aplikasi yang dibutuhkan: MidiKeyboard , MidiSynthExample
Ini menguji enumerasi perangkat, perangkat virtual, koneksi port, dan pengiriman pesan.
- Sesuaikan volume pada perangkat Android menjadi sekitar setengah.
- Arahkan ponsel dalam mode lansekap.
- Luncurkan aplikasi MidiKeyboard .
- Pilih SynthExample dari menu pemintal.
- Mainkan kunci. Anda akan mendengar nada dimainkan di aplikasi SynthExample .
- Keluar dari aplikasi dengan menekan tombol Back sehingga port akan tertutup.
Tes USB: mode host
Perangkat keras yang dibutuhkan: Keyboard MIDI USB, kabel USB, adaptor OTG
Ulangi tes ini beberapa kali. Kami telah melihat tumpukan USB macet parah pada beberapa perangkat prototipe jika perangkat dicolokkan dan dicabut beberapa kali.
Keyboard sudah terpasang
Aplikasi yang dibutuhkan: MidiSynthExample atau MidiScope
Ini menguji USB MIDI dalam mode host.
- Sesuaikan volume pada perangkat Android menjadi sekitar setengah.
- Colokkan keyboard USB menggunakan adaptor OTG.
- Luncurkan aplikasi SynthExample atau aplikasi MidiScope .
- Dari menu pilih keyboard USB. Ini akan menampilkan merek.
- Memutar not di keyboard. Jika Anda menjalankan SynthExample maka Anda akan mendengar nada yang dimainkan di telepon. Jika Anda menjalankan MidiScope maka Anda akan melihat pesan NoteOn dan NoteOff di layar.
- Cabut keyboard. Menu Sender for Synth akan menampilkan - - - - - .
- Keluar dari aplikasi dengan menekan tombol Kembali .
Keyboard USB colokan panas
Aplikasi yang dibutuhkan: MidiSynthExample atau MidiScope
Ini menguji USB MIDI dalam mode host.
- Sesuaikan volume pada perangkat Android menjadi sekitar setengah.
- Pastikan tidak ada keyboard USB MIDI yang terpasang.
- Luncurkan aplikasi SynthExample .
- Di tengah, di sebelah Sender for Synth , lihat di menu. Anda seharusnya tidak melihat keyboard USB terdaftar.
- Colokkan keyboard USB menggunakan adaptor OTG.
- Di tengah, di samping Pengirim untuk Synth , pilih keyboard USB. Ini akan menampilkan merek.
- Memutar not di keyboard. Anda akan mendengar nada yang dimainkan di telepon.
- Di tengah, di sebelah Pengirim untuk Synth , pilih - - - - - .
- Memutar not di keyboard. Anda harus mendengar apa-apa.
- Di tengah, di samping Pengirim untuk Synth , pilih keyboard USB. Ini akan menampilkan merek.
- Memutar not di keyboard. Anda akan mendengar nada yang dimainkan di telepon.
- Cabut synthesizer. Menu Sender for Synth akan menampilkan - - - - - .
- Keluar dari aplikasi dengan menekan tombol Kembali .
Tes USB: mode periferal
Perangkat keras yang dibutuhkan: kabel USB, adaptor OTG
Android-ke-Android
Aplikasi yang dibutuhkan: MidiKeyboard di perangkat Android yang sedang diuji, MidiScope di perangkat Android lain.
Gunakan 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 memodifikasi pengujian agar berfungsi dengan komputer desktop yang menjalankan perangkat lunak 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 yang lain ke perangkat Android B kedua yang beroperasi dalam mode host.
- Pada perangkat Android A:
- Seret jari ke bawah dari atas layar.
- Pilih USB untuk ikon Pengisian .
- Pilih MIDI .
- Luncurkan aplikasi MidiKeyboard .
- Pilih Android USB Peripheral Port dari menu Receiver for Keys di atas.
- Pada perangkat Android B:
- Luncurkan aplikasi MidiScope .
- Pilih perangkat Android lainnya sebagai sumber.
- Pada perangkat Android A:
- Putar not di keyboard dan cari NoteOn dan NoteOff di perangkat Android B.
tes BLE
Perangkat keras yang dibutuhkan: Keyboard MIDI yang mendukung BLE
Memasangkan dan bermain dasar
Aplikasi yang dibutuhkan: MidiBtlePairing , MidiSynthExample
Uji keyboard yang terhubung ke Android melalui BLE.
- Nyalakan ulang perangkat Android.
- Nyalakan keyboard BLE.
(Keyboard Miselu C.24 dihidupkan dengan menekan tombol di dekat bagian belakang sehingga terbuka. Tombol daya pada C.24 berkedip biru saat dalam mode berpasangan.) - Luncurkan aplikasi MidiBtlePairing . Ini memiliki ikon MIDI + BTLE .
- Tekan tombol Pindai Bluetooth .
- Pilih periferal BLE yang diinginkan.
- Aplikasi akan kembali ke halaman utama, dan Anda akan melihat periferal terdaftar. Jika Anda menggunakan C.24, maka Anda akan melihat bahwa lampu harus berubah menjadi hijau pada C.24 untuk menunjukkan mode berpasangan.
- Keluar dari aplikasi dengan menekan tombol Beranda , bukan tombol Kembali .
- Luncurkan aplikasi SynthExample.
- Pilih keyboard BLE sebagai pengirim dari menu.
- Anda harus dapat menekan tombol pada keyboard BLE dan mendengar catatan di Android.