Интерфейс 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 не диктует, должны ли звучащие ноты переключиться на новый инструмент (тембр) или продолжать использовать свой исходный тембр до завершения с помощью команды note-off.

Номер программы нулевой (выражается от 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)

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

«Моно» — сокращение от слова «монофонический», которое в данном контексте противопоставляется слову «полифонический» и относится к одному голосу синтезатора на один 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 означает, что канал может звучать (если другие каналы не выделены).

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

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

boolean getMute()

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

void setSolo(boolean soloState)

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

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

boolean getSolo()

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