Интерфейс 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, MSB громкости канала) на 128 и добавив значение контроллера 39 (0x27, LSB громкости канала).

Если устройство не поддерживает настройку определенного контроллера, этот метод возвращает 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)

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

«Моно» — сокращенное от «монофонический», что в данном контексте противопоставляется слову «полифонический» и относится к одному голосу синтезатора на один 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 для этого канала. Если solo равно true, то будут звучать только этот канал и другие выделенные каналы. Если solo равно false, то будут звучать только другие выделенные каналы, если нет выделенных каналов, то все невыключенные каналы будут звучать.

boolean getSolo()

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