Интерфейс MidiChannel

void noteOn(int noteNumber, int velocity)

Запускает звучание указанной ноты. Скорость нажатия клавиши обычно управляет громкостью и/или яркостью ноты. Если velocity равно нулю, этот метод действует как noteOff(int), завершая звучание ноты.

void noteOff(int noteNumber, int velocity)

Заглушает указанную ноту. Скорость отпускания клавиши, если она не игнорируется, может использоваться для управления скоростью затухания ноты. В любом случае, нота может не затухать мгновенно; скорость затухания определяется внутренними механизмами Instrument. Если педаль Sustain (контроллер; см. controlChange) нажата, действие этого метода откладывается до момента отпускания педали.

void noteOff(int noteNumber)

Заглушает указанную ноту.

void setPolyPressure(int noteNumber, int pressure)

Реагирует на изменение давления на указанную ноту. Полифоническое давление на клавишу позволяет пианисту одновременно нажимать несколько клавиш, каждая с разной силой. Давление, если оно не игнорируется, обычно используется для изменения таких характеристик ноты, как громкость, яркость или вибрато.

Возможно, что используемый синтезатор не поддерживает этот MIDI-сообщение. Для проверки успешного выполнения setPolyPressure, используйте getPolyPressure.

int getPolyPressure(int noteNumber)

Получает силу нажатия указанной клавиши.

Если устройство не поддерживает полифоническое давление, этот метод всегда возвращает 0. Вызов setPolyPressure не окажет никакого влияния.

void setChannelPressure(int pressure)

Реагирует на изменение давления на клавиатуру. Давление на канал указывает на то, насколько сильно музыкант нажимает на всю клавиатуру. Это может быть максимальное или среднее значение значений датчиков давления каждой клавиши, заданных setPolyPressure. Чаще всего это измерение одного датчика на устройстве, которое не реализует полифоническое давление на клавишу. Давление может использоваться для управления различными аспектами звука, как описано в setPolyPressure.

Возможно, что используемый синтезатор не поддерживает это MIDI-сообщение. Для проверки успешного выполнения setChannelPressure, используйте getChannelPressure.

int getChannelPressure()

Получает давление на клавиатуру канала.

Если устройство не поддерживает установку давления на канал, этот метод всегда возвращает 0. Вызов setChannelPressure не окажет никакого влияния.

void controlChange(int controller, int value)

Реагирует на изменение значения указанного контроллера. Контроллер — это любой элемент управления, кроме клавиши клавиатуры, такой как переключатель, ползунок, педаль, колесо или датчик давления воздуха. Спецификация MIDI 1.0 предоставляет стандартные номера для типовых контроллеров на MIDI-устройствах и описывает предполагаемое действие для некоторых из них. Способ, которым Instrument реагирует на изменение контроллера, может быть специфичным для Instrument.

Спецификация MIDI 1.0 определяет контроллеры с 7-битным и 14-битным представлением. Непрерывные контроллеры, такие как колёса и ползунки, обычно имеют 14 бит (два байта MIDI), в то время как дискретные контроллеры, такие как переключатели, обычно имеют 7 бит (один байт MIDI). Обратитесь к спецификации, чтобы увидеть ожидаемое разрешение для каждого типа управления.

Контроллеры с 64 по 95 (0x40 - 0x5F) позволяют 7-битную точность. Значение 7-битного контроллера полностью определяется аргументом value. Дополнительный набор контроллеров обеспечивает 14-битную точность, используя два номера контроллеров, один для старших 7 бит и другой для младших 7 бит. Номера контроллеров с 0 по 31 (0x00 - 0x1F) управляют старшими 7 битами 14-битных контроллеров; номера контроллеров с 32 по 63 (0x20 - 0x3F) управляют младшими 7 битами этих контроллеров. Например, контроллер номер 7 (0x07) управляет старшими 7 битами громкости канала, а контроллер номер 39 (0x27) управляет младшими 7 битами. Значение 14-битного контроллера определяется взаимодействием этих двух частей. Когда старшие 7 биты контроллера устанавливаются (используя номера контроллеров с 0 по 31), младшие 7 биты автоматически устанавливаются в 0. Затем соответствующий номер контроллера для младших 7 бит может быть использован для дальнейшей модуляции значения контроллера.

Возможно, что используемый синтезатор не поддерживает определённое сообщение контроллера. Чтобы проверить успешность вызова controlChange, используйте getController.

int getController(int controller)

Получает текущее значение указанного контроллера. Значение возврата представлено 7 битами. Для 14-битных контроллеров необходимо получить значения MSB и LSB контроллера отдельно. Например, 14-битное значение контроллера громкости можно вычислить, умножив значение контроллера 7 (0x07, старшие 7 биты громкости канала) на 128 и прибавив значение контроллера 39 (0x27, младшие 7 биты громкости канала).

Если устройство не поддерживает установку конкретного контроллера, этот метод возвращает 0 для этого контроллера. Вызов controlChange не окажет никакого влияния.

void programChange(int program)

Изменяет программу (паттерн). Это позволяет выбрать определённый инструмент из текущего банка инструментов.

Спецификация MIDI не диктует, должны ли уже звучащие ноты переключиться на новый инструмент (тембр) или продолжать звучать своим оригинальным тембром до момента их выключения.

Номер программы является нулевым (выражен от 0 до 127). Обратите внимание, что MIDI-оборудование и литература о MIDI обычно используют диапазон от 1 до 128.

Возможно, что используемый синтезатор не поддерживает определённую программу. Чтобы проверить успешность вызова programChange, используйте getProgram.

void programChange(int bank, int program)

Изменяет программу с использованием номеров банка и программы (паттерна).

Возможно, что используемый синтезатор не поддерживает определённый банк или программу. Чтобы проверить успешность вызова programChange, используйте getProgram и getController. Поскольку банки изменяются посредством изменений управления, вы можете проверить текущий банк с помощью следующей инструкции:

   int bank = (getController(0) * 128) + getController(32);
 

int getProgram()

Получает текущий номер программы для этого канала.

void setPitchBend(int bend)

Изменяет смещение высоты тона для всех нот на этом канале. Это влияет на все звучащие в данный момент ноты, а также на последующие. (Для прекращения изменения высоты тона значение необходимо сбросить до центрального положения.)

Спецификация MIDI предусматривает, что изменение высоты тона представляет собой 14-битовое значение, где ноль — максимальное понижение, 16383 — максимальное повышение, а 8192 — центр (без изменения высоты тона). Фактическая величина изменения высоты тона не указана; она может быть изменена настройкой чувствительности к изменению высоты тона. Однако спецификация General MIDI гласит, что диапазон по умолчанию должен составлять две полутона вверх и вниз от центра.

Возможно, что базовый синтезатор не поддерживает этот MIDI-сообщение. Для проверки того, что setPitchBend выполнено успешно, используйте getPitchBend.

int getPitchBend()

Получает смещение высоты тона вверх или вниз для этого канала. Если устройство не поддерживает установку изменения высоты тона, этот метод всегда возвращает 8192. Вызов setPitchBend в этом случае не окажет никакого влияния.

void resetAllControllers()

Сбрасывает все реализованные контроллеры до их значений по умолчанию.

void allNotesOff()

Отключает все ноты, которые сейчас звучат на этом канале. Ноты могут не затихнуть мгновенно; их скорость затухания определяется внутренними механизмами Instrument. Если контроллер педали Sustain (см. controlChange) нажат, эффект этого метода откладывается до момента отпускания педали.

void allSoundOff()

Немедленно отключает все звучащие ноты на этом канале, игнорируя состояние педали Sustain и внутреннюю скорость затухания текущего Instrument.

boolean localControl(boolean on)

Включает или выключает локальный контроль. По умолчанию локальный контроль включен. Включенное состояние означает, что если устройство способно как синтезировать звук, так и передавать MIDI-сообщения, оно будет синтезировать звук в ответ на сообщения note-on и note-off, которые оно само передает. Оно также будет реагировать на сообщения, полученные от других устройств передачи. Выключенное состояние означает, что синтезатор будет игнорировать свои собственные передаваемые MIDI-сообщения, но не сообщения, полученные от других устройств.

Возможно, что базовый синтезатор не поддерживает локальный контроль. Для проверки того, что вызов localControl был успешным, проверьте возвращаемое значение.

void setMono(boolean on)

Включает или выключает режим моно. В режиме моно канал синтезирует только одну ноту за раз. В режиме полифонии (эквивалентен режиму моно выключен) канал может синтезировать несколько нот одновременно. По умолчанию режим моно выключен (режим полифонии включен).

"Mono" — сокращение от слова "monophonic", которое в данном контексте противопоставляется слову "polyphonic" и относится к одному голосу синтезатора на MIDI-канале. Это не имеет отношения к количеству аудиоканалов (как в "монофонических" и "стереофонических" записях).

Возможно, что базовый синтезатор не поддерживает режим моно. Чтобы убедиться, что вызов setMono был успешен, используйте getMono.

boolean getMono()

Получает текущий режим моно/полифонии. Синтезаторы, которые не позволяют изменять режим моно/полифонии, всегда будут возвращать одно и то же значение, независимо от вызовов setMono.

void setOmni(boolean on)

Включает или выключает режим omni. В режиме omni канал реагирует на сообщения, отправленные на все каналы. Когда omni выключен, канал реагирует только на сообщения, отправленные на его номер канала. По умолчанию omni выключен.

Возможно, что базовый синтезатор не поддерживает режим omni. Для проверки того, что setOmni было успешным, используйте getOmni.

boolean getOmni()

Получает текущий режим omni. Синтезаторы, которые не позволяют изменить режим omni, всегда будут возвращать одно и то же значение, независимо от вызовов setOmni.

void setMute(boolean mute)

Устанавливает состояние отключения звука для этого канала. Значение true означает, что канал должен быть отключен, значение false означает, что канал может звучать (если другие каналы не включены в режиме solo).

В отличие от allSoundOff(), этот метод применяется только к определённому каналу, а не ко всем каналам. Кроме того, он не только выключает текущие звучащие ноты, но и последующие принимаемые ноты.

Возможно, что базовый синтезатор не поддерживает отключение звука каналов. Чтобы проверить, что вызов setMute был успешен, используйте getMute.

boolean getMute()

Получает текущее состояние отключения звука для этого канала. Если базовый синтезатор не поддерживает отключение звука для этого канала, этот метод всегда возвращает false.

void setSolo(boolean soloState)

Устанавливает состояние solo для этого канала. Если solo равно true, то будут звучать только этот канал и другие каналы в режиме solo. Если solo равно false, то будут звучать только другие каналы в режиме solo, если нет каналов в режиме solo, то все не выключенные каналы будут звучать.

boolean getSolo()

Получает текущее состояние solo для этого канала. Если базовый синтезатор не поддерживает solo для этого канала, этот метод всегда возвращает false.