Интерфейс секвенсора

static final int LOOP_CONTINUOUSLY

Значение, указывающее на то, что циклическое воспроизведение должно продолжаться бесконечно, а не завершаться после определённого числа циклов.

void setSequence(Sequence sequence) throws InvalidMidiDataException

Устанавливает текущую последовательность, с которой работает секвенсор.

Этот метод можно вызывать, даже если Sequencer закрыт.

void setSequence(InputStream stream) throws IOException, InvalidMidiDataException

Устанавливает текущую последовательность, с которой работает секвенсор. Поток должен указывать на данные файла MIDI.

Этот метод можно вызывать, даже если Sequencer закрыт.

Sequence getSequence()

Получает последовательность, с которой в данный момент работает секвенсор.

Этот метод можно вызывать, даже если Sequencer закрыт.

void start()

Запускает воспроизведение данных MIDI в загруженной последовательности. Воспроизведение начнется с текущей позиции. Если позиция воспроизведения достигнет конечной точки цикла, а количество повторов больше 0, воспроизведение возобновится в начальной точке цикла на количество повторений, заданное с помощью setLoopCount. После этого или если количество повторов равно 0, воспроизведение продолжится до конца последовательности.

Реализация гарантирует, что синтезатор при переходе к начальной точке цикла переведён в согласованное состояние путём отправки соответствующих событий управления, изменения высоты тона и смены программ.

void stop()

Останавливает запись, если она активна, и воспроизведение текущей загруженной последовательности, если таковое имеется.

boolean isRunning()

Указывает, запущена ли в данный момент работа секвенсора. По умолчанию false. Секвенсор начинает работать при вызове либо start(), либо startRecording(). isRunning тогда возвращает true до тех пор, пока воспроизведение последовательности не завершится или не будет вызван stop().

void startRecording()

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

Обратите внимание, что дорожки по умолчанию не включены для записи. Для записи данных MIDI хотя бы одна дорожка должна быть специально включена для записи.

void stopRecording()

Останавливает запись, если она активна. Воспроизведение текущей последовательности продолжается.

boolean isRecording()

Указывает, активна ли в данный момент запись в секвенсоре. По умолчанию false. Секвенсор начинает запись при вызове startRecording() и затем возвращает true до тех пор, пока не будет вызван stop() или stopRecording().

void recordEnable(Track track, int channel)

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

void recordDisable(Track track)

Отключает запись в указанную дорожку. События больше не будут записываться в эту дорожку.

float getTempoInBPM()

Получает текущее темпо, выраженное в ударах в минуту. Фактическое темпо воспроизведения — это произведение возвращаемого значения и коэффициента темпо.

void setTempoInBPM(float bpm)

Устанавливает темпо в ударах в минуту. Фактическое темпо воспроизведения — это произведение указанного значения и коэффициента темпо.

float getTempoInMPQ()

Получает текущее темпо, выраженное в микросекундах на четверть ноты. Фактическое темпо воспроизведения — это произведение возвращаемого значения и коэффициента темпо.

void setTempoInMPQ(float mpq)

Устанавливает темпо в микросекундах на четверть ноты. Фактическое темпо воспроизведения — это произведение указанного значения и коэффициента темпо.

void setTempoFactor(float factor)

Изменяет фактическое темпо воспроизведения секвенсора с помощью предоставленного коэффициента. Значение по умолчанию — 1.0. Значение 1.0 соответствует естественной скорости (темпо, указанному в последовательности), 2.0 — вдвое быстрее и т. д. Коэффициент темпо не влияет на значения, возвращаемые getTempoInMPQ() и getTempoInBPM(). Эти значения указывают темпо до масштабирования.

Обратите внимание, что коэффициент темпо нельзя настроить при использовании внешней синхронизации. В этом случае setTempoFactor всегда устанавливает коэффициент темпо в 1.0.

float getTempoFactor()

Возвращает текущий коэффициент темпа для секвенсора. По умолчанию равен 1,0.

long getTickLength()

Получает длительность текущей последовательности, выраженную в тиках MIDI, или 0, если последовательность не задана.

long getTickPosition()

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

void setTickPosition(long tick)

Устанавливает текущую позицию секвенсора в тиках MIDI.

long getMicrosecondLength()

Получает длительность текущей последовательности, выраженную в микросекундах, или 0, если последовательность не задана.

long getMicrosecondPosition()

Получает текущую позицию в последовательности, выраженную в микросекундах.

void setMicrosecondPosition(long microseconds)

Устанавливает текущую позицию в последовательности, выраженную в микросекундах.

void setMasterSyncMode(Sequencer.SyncMode sync)

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

Sequencer.SyncMode getMasterSyncMode()

Получает текущий режим синхронизации с мастером для этого секвенсора.

Sequencer.SyncMode[] getMasterSyncModes()

Получает набор режимов синхронизации с мастером, поддерживаемых этим секвенсором.

void setSlaveSyncMode(Sequencer.SyncMode sync)

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

Sequencer.SyncMode getSlaveSyncMode()

Получает текущий режим синхронизации ведомого для этого секвенсора.

Sequencer.SyncMode[] getSlaveSyncModes()

Получает набор режимов синхронизации ведомого, поддерживаемых секвенсором.

void setTrackMute(int track, boolean mute)

Устанавливает состояние отключения для дорожки. Этот метод может завершиться неудачей по ряду причин. Например, указанный номер дорожки может быть недействительным для текущей последовательности, или секвенсор может не поддерживать эту функциональность. Приложение, которое нужно проверить, был ли этот процесс успешным, должно последовать этому вызову вызовом getTrackMute(int).

boolean getTrackMute(int track)

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

void setTrackSolo(int track, boolean solo)

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

Этот метод может завершиться неудачей по ряду причин. Например, указанный номер дорожки может быть недействительным для текущей последовательности, или секвенсор может не поддерживать эту функциональность. Приложение, которое нужно проверить, был ли этот процесс успешным, должно последовать этому вызову вызовом getTrackSolo(int).

boolean getTrackSolo(int track)

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

boolean addMetaEventListener(MetaEventListener listener)

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

void removeMetaEventListener(MetaEventListener listener)

Удаляет указанного слушателя событий мета-событий из списка зарегистрированных слушателей этого секвенсора, если слушатель действительно зарегистрирован.

int[] addControllerEventListener(ControllerEventListener listener, int[] controllers)

Регистрирует слушателя событий контроллера для получения уведомлений всякий раз, когда секвенсор обрабатывает событие изменения контроллера запрошенного типа или типов. Типы задаются аргументом controllers, который должен содержать массив номеров MIDI-контроллеров. (Каждое число должно быть от 0 до 127 включительно. См. спецификацию MIDI 1.0 для номеров, соответствующих различным типам контроллеров.)

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

int[] removeControllerEventListener(ControllerEventListener listener, int[] controllers)

Удаляет интерес слушателя событий контроллера к одному или нескольким типам событий контроллера. Аргумент controllers — это массив номеров MIDI, соответствующих контроллерам, для которых слушатель больше не должен получать уведомления об изменениях. Чтобы полностью удалить этого слушателя из списка зарегистрированных слушателей, передайте null для controllers. Возвращаемый массив содержит номера MIDI-контроллеров, для которых слушатель теперь будет получать события. Длина массива равна 0, если слушатель не будет получать уведомления об изменениях для каких-либо контроллеров.

void setLoopStartPoint(long tick)

Устанавливает первую метку MIDI, которая будет воспроизводиться в цикле. Если количество циклов больше 0, воспроизведение перейдёт к этой точке при достижении точки окончания цикла.

Значение 0 для начальной точки означает начало загруженной последовательности. Начальная точка должна быть меньше или равна конечной точке, и она должна находиться в пределах размера загруженной последовательности.

Начальная точка цикла секвенсора по умолчанию - начало последовательности.

long getLoopStartPoint()

Получает начальную позицию цикла в метках MIDI.

void setLoopEndPoint(long tick)

Устанавливает последнюю метку MIDI, которая будет воспроизводиться в цикле. Если количество циклов равно 0, конечная точка цикла не имеет эффекта, и воспроизведение продолжает воспроизведение при достижении конечной точки цикла.

Значение -1 для конечной точки указывает на последнюю метку последовательности. В противном случае, конечная точка должна быть больше или равна начальной точке, и она должна находиться в пределах размера загруженной последовательности.

Конечная точка цикла секвенсора по умолчанию - -1, что означает конец последовательности.

long getLoopEndPoint()

Получает конечную позицию цикла в метках MIDI.

void setLoopCount(int count)

Устанавливает количество повторений цикла для воспроизведения. Когда позиция воспроизведения достигает конечной точки цикла, она возвращается к начальной точке цикла count раз, после чего воспроизведение продолжается до конца последовательности.

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

Значение count 0 отключает цикл: воспроизведение будет продолжаться в конечной точке цикла и не возвращаться к начальной точке цикла. Это значение по умолчанию для секвенсора.

Если воспроизведение останавливается во время цикла, текущий статус цикла сбрасывается; последующие запросы на запуск не влияют на прерванную операцию цикла.

int getLoopCount()

Получает количество повторений для воспроизведения.