Функция HandleMIDI() позволяет обрабатывать MIDI-события, которые получает плагин. Функция HandleMIDI вызывается каждый раз, когда MIDI-событие принимается плагином и она нужна для обработки входящих MIDI-событий. Если вы не реализуете функцию HandleMIDI, события проходят через плагин без изменений.
HandleMIDI вызывается с одним аргументом, который является объектом JavaScript, представляющим входящие MIDI-события. Использование объектов HandleMIDI и JavaScript Event показано на примерах.
Пример кода 1
Пропуск MIDI-событий через плагин.
function HandleMIDI(event) {
event.send(); }
Пример кода 2
Регистрация событий в плагинной консоли (log) и никакой передачи их куда бы то ни было.
function HandleMIDI(event) {
event.trace();
}
Пример кода 3
Повторение нот на одну октаву выше с задержкой 100 мс и пропуск всех других событий через плагин без изменений.
Текст, следующий за двойным слэшем //, является комментариями.
function HandleMIDI(event) {
event.send(); // послать исходное событие
if (event instanceof Note) { // если это нота
event.pitch += 12; // транспонировать на одну октаву вверх
event.sendAfterMilliseconds(100); // послать после задержки
}
}