Интерфейс Sequencer

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()

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