Эти тесты можно использовать для проверки функции MIDI на устройствах Android. Успешное выполнение этих тестов – обязательное условие для заявления о поддержке MIDI.
Подготовка
Аппаратное обеспечение
Для тестирования требуется следующее оборудование:
- MIDI-клавиатура с USB-разъемом.
- MIDI-клавиатура с поддержкой Bluetooth с низким энергопотреблением (BLE)
- USB-кабели;
- Адаптер USB On-The-Go (OTG) для преобразования разъема USB-A в разъем micro-USB или USB-C
- Устройство Android с ОС Android 6.0 Marshmallow или более поздней версии.
- Необязательно: настольный компьютер.
Некоторые MIDI-клавиатуры поддерживают как USB, так и BLE-MIDI, поэтому вы можете проводить тестирование, используя только одну клавиатуру. Примеры: Akai LPK25 Wireless и Korg Microkey Air.
Приложения
В процедуре тестирования используются несколько приложений. Исходный код приложений доступен в проекте GitHub android-midisuite, а сами приложения можно скачать в Google Play™ по ссылкам в таблице ниже.
| Исходный код | Google Play™ | Описание |
|---|---|---|
| MidiScope или MidiScope | MIDI Scope | отображает MIDI-сообщения на экране; |
| MidiKeyboard | MIDI-клавиатура | отправляет MIDI-сообщения, нажимая на экранную музыкальную клавиатуру; |
| MidiSynthExample или MidiSynth. |
MIDI Synth Ex | простой MIDI-синтезатор, использующий генераторы пилообразных волн; |
| MidiBtlePairing | MIDI BLE Connect | подключает устройство Android к периферийному устройству BLE |
| MidiTools | зависимость библиотеки от указанных выше приложений; |
Если вы хотите работать с исходным кодом, а не устанавливать приложение через Google Play™, сначала создайте приложение с помощью предоставленного файла Android.mk. Затем установите приложение с помощью Android Debug Bridge (ADB). Например, чтобы установить приложение MidiScope:
- Используйте рабочую станцию с установленным ADB.
- Подключите рабочую станцию к устройству Android с помощью USB-кабеля.
- Возможно, вам потребуется разрешить USB-подключение на устройстве Android. Подробнее о периферийном режиме USB…
- На рабочей станции введите:
cd THIS_FOLDERadb install -r MidiScope.apk
Тестирование виртуального синтезатора
Обратите внимание, что у входного MIDI-порта может быть только одно подключение. Если порт ввода уже используется другим приложением, он будет недоступен. Если подключиться к порту ввода не удается, попробуйте закрыть другие приложения.
Необходимое оборудование: тестируемое устройство Android
Простое подключение
Необходимые приложения: MidiKeyboard, MidiSynthExample
Проверяется перечисление устройств, виртуальные устройства, подключения к портам и отправка сообщений.
- Установите громкость на устройстве Android примерно на среднем уровне.
- Поверните телефон горизонтально.
- Запустите приложение MidiKeyboard.
- В меню выберите SynthExample.
- Нажимать клавиши. В приложении SynthExample должны воспроизводиться ноты.
- Чтобы закрыть порт, выйдите из приложения, нажав кнопку Назад.
Тестирование USB: режим хоста
Необходимое оборудование: USB-клавиатура MIDI, USB-кабель, OTG-адаптер
Повторите эти тесты несколько раз. Мы заметили, что при подключении и отключении устройств несколько раз на некоторых прототипах устройств происходит сбой стека USB.
Клавиатура уже подключена
Необходимые приложения: MidiSynthExample или MidiScope.
Это тестирование USB MIDI в режиме хоста.
- Установите громкость на устройстве Android примерно на средний уровень.
- Подключите USB-клавиатуру с помощью OTG-адаптера.
- Запустите приложение SynthExample или MidiScope.
- В меню выберите USB-клавиатуру. На экране появится название бренда.
- Играть ноты на клавиатуре. Если вы запустили SynthExample, то должны услышать, как телефон воспроизводит ноты. Если вы запустили MidiScope, на экране должны появиться сообщения NoteOn и NoteOff.
- Отключите клавиатуру. В меню Отправитель для Synth должно быть указано - - - - -.
- Чтобы выйти из приложения, нажмите кнопку Назад.
Горячее подключение USB-клавиатуры
Необходимые приложения: MidiSynthExample или MidiScope.
Это тестирование USB MIDI в режиме хоста.
- Установите громкость на устройстве Android примерно на среднем уровне.
- Убедитесь, что не подключена USB MIDI-клавиатура.
- Запустите приложение SynthExample.
- В центре, рядом с пунктом Отправитель для Synth, посмотрите в меню. Клавиатура USB не должна быть указана в списке.
- Подключите USB-клавиатуру с помощью OTG-адаптера.
- В середине экрана рядом с пунктом Sender for Synth (Отправитель для синтезатора) выберите USB-клавиатуру. На экране появится бренд.
- Играть ноты на клавиатуре. Вы должны услышать, как на телефоне воспроизводятся ноты.
- В середине страницы рядом с пунктом Отправитель для Synth выберите - - - - -.
- Сыграйте ноты на клавиатуре. Вы не должны ничего слышать.
- В середине экрана рядом с пунктом Sender for Synth (Отправитель для синтезатора) выберите USB-клавиатуру. На экране появится бренд.
- Сыграйте ноты на клавиатуре. Вы должны услышать, как на телефоне воспроизводятся ноты.
- Отключите синтезатор. В меню Отправитель для Synth должно быть указано - - - - -.
- Чтобы выйти из приложения, нажмите кнопку Назад.
Тестирование USB: периферийный режим
Оборудование: USB-кабель, OTG-адаптер
С Android на Android
Необходимые приложения: MidiKeyboard на тестируемом устройстве Android, MidiScope на другом устройстве Android.
Используйте устройства Android в качестве периферийного контроллера для другого устройства Android. Для тестирования этого режима используйте другое устройство Android, работающее в режиме хоста. Обратите внимание, что вы можете изменить тест, чтобы он работал с настольным компьютером, на котором запущено программное обеспечение цифровой звуковой рабочей станции (DAW), например GarageBand.
- Подключите USB-кабель к тестируемому устройству Android (устройство Android А).
- Подключите другой конец кабеля к устройству Android Б, работающему в режиме хоста, с помощью OTG-адаптера.
- На устройстве Android А:
- Проведите пальцем вниз от верхнего края экрана.
- Нажмите на значок USB для зарядки.
- Выберите MIDI.
- Запустите приложение MidiKeyboard.
- В меню Receiver for Keys (Приемник для ключей) вверху выберите Android USB Peripheral Port (Периферийный USB-порт Android).
- На устройстве Android B:
- Запустите приложение MidiScope.
- Выберите другое устройство Android в качестве источника.
- На устройстве Android А:
- Нажимайте клавиши на клавиатуре и проверяйте, появляются ли на устройстве Б сообщения NoteOn и NoteOff.
Тест BLE
Оборудование: MIDI-клавиатура с поддержкой BLE
Как подключить наушники и начать воспроизведение
Необходимые приложения: MidiBtlePairing, MidiSynthExample.
Протестируйте клавиатуру, подключенную к Android по BLE.
- Перезагрузите устройство Android.
- Включите клавиатуру BLE.
(Чтобы включить клавиатуру Miselu C.24, нажмите кнопку на задней панели. Кнопка питания на C.24 мигает синим цветом, когда устройство находится в режиме подключения. - Запустите приложение MidiBtlePairing. Его значок выглядит как MIDI+BTLE.
- Нажмите кнопку Поиск Bluetooth-устройств.
- Выберите нужное периферийное устройство BLE.
- Приложение должно вернуться на главную страницу, и вы увидите в списке подключенное устройство. Если вы используете C.24, то увидите, что индикатор на ней загорелся зеленым, показывая, что режим сопряжения включен.
- Выйдите из приложения, нажав кнопку Домой, а не Назад.
- Запустите приложение SynthExample.
- Выберите в меню клавиатуру BLE в качестве отправителя.
- При нажатии клавиш на BLE-клавиатуре вы должны слышать ноты на устройстве Android.