javax.sound.midi

Интерфейсный Синтезатор

Все Суперинтерфейсы:

AutoCloseable, MidiDevice

public interface Synthesizer
extends MidiDevice

A Synthesizer генерирует звук. Это обычно происходит когда один из Synthesizer's MidiChannel объекты получают a noteOn сообщение, или непосредственно или через Synthesizer объект. Многие Synthesizers поддержка Receivers, через который события MIDI могут быть поставлены Synthesizer. В таких случаях, Synthesizer обычно отвечает, отправляя соответствующее сообщение к соответствующему MidiChannel, или обрабатывая событие непосредственно, если событие не является одним из сообщений канала MIDI.

Synthesizer интерфейс включает методы для инструментов загрузки и разгрузки от soundbanks. Инструмент является спецификацией для того, чтобы синтезировать определенный тип звука, эмулирует ли тот звук традиционный инструмент или является некоторым звуковым эффектом или другим воображаемым звуком. soundbank является набором инструментов, организованных банком и числом программы (через инструмент Patch объект). Отличающийся Synthesizer классы могли бы реализовать различные методы синтеза звука, означая, что некоторые инструменты и не другие могли бы быть совместимыми с данным синтезатором. Кроме того, у синтезаторов может быть ограниченный объем памяти для инструментов, означая, что не каждый soundbank и инструмент могут использоваться каждым синтезатором, даже если метод синтеза является совместимым. Чтобы видеть, могут ли инструменты от определенного soundbank играться данным синтезатором, вызовите isSoundbankSupported метод Synthesizer.

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

См. Также:

MidiSystem.getSynthesizer(), Soundbank, Instrument, MidiChannel.programChange(int, int), Receiver, Transmitter, MidiDevice

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от интерфейса javax.sound.midi. MidiDevice

MidiDevice. Информация

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Инструмент[]	getAvailableInstruments() Получает список инструментов, которые идут с синтезатором.
MidiChannel[]	getChannels() Получает набор каналов MIDI, которыми управляет этот синтезатор.
Soundbank	getDefaultSoundbank() Получает значение по умолчанию soundbank для синтезатора, если Вы существуете.
long	getLatency() Получает задержку обработки, понесенную этим синтезатором, выраженным в микросекундах.
Инструмент[]	getLoadedInstruments() Получает список инструментов, которые в настоящий момент загружаются на это Synthesizer.
int	getMaxPolyphony() Получает максимальное количество примечаний, которыми этот синтезатор может звучать одновременно.
VoiceStatus[]	getVoiceStatus() Получает текущий статус речи, произведенной этим синтезатором.
boolean	isSoundbankSupported(Soundbank soundbank) Сообщает вызывающей стороне, способен ли этот синтезатор к загружающимся инструментам от указанного soundbank.
boolean	loadAllInstruments(Soundbank soundbank) Загрузки на Synthesizer все инструменты содержатся в указанном Soundbank.
boolean	loadInstrument(Instrument instrument) Делает определенный инструмент доступным для синтеза.
boolean	loadInstruments(Soundbank soundbank, Patch[] patchList) Загружает инструменты, на которые ссылаются указанные патчи, от указанного Soundbank.
boolean	remapInstrument(Instrument from, Instrument to) Повторно отображает инструмент.
void	unloadAllInstruments(Soundbank soundbank) Разгружает все инструменты, содержавшиеся в указанном Soundbank.
void	unloadInstrument(Instrument instrument) Разгружает определенный инструмент.
void	unloadInstruments(Soundbank soundbank, Patch[] patchList) Разгружает инструменты, на которые ссылаются указанные патчи, от определенного банка звуков MIDI.

Методы, наследованные от интерфейса javax.sound.midi. MidiDevice

close, getDeviceInfo, getMaxReceivers, getMaxTransmitters, getMicrosecondPosition, getReceiver, getReceivers, getTransmitter, getTransmitters, isOpen, open

Деталь метода

getMaxPolyphony

int getMaxPolyphony()

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

Возвраты:

максимальное количество одновременных примечаний

См. Также:

getVoiceStatus()

getLatency

long getLatency()

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

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

Возвраты:

задержка худшего случая, в микросекундах

getChannels

MidiChannel[] getChannels()

Получает набор каналов MIDI, которыми управляет этот синтезатор. Каждый ненулевой элемент в возвращенном массиве является a MidiChannel это получает сообщения MIDI, отправленные на том номере канала.

MIDI 1.0 спецификации предусматривают 16 каналов, таким образом, этот метод возвращает массив по крайней мере 16 элементов. Однако, если этот синтезатор не использует все 16 каналов, некоторые из элементов массива могли бы быть null, таким образом, следует проверить каждый элемент перед использованием этого.

Возвраты:

массив MidiChannel объекты управляли этим Synthesizer. Некоторые из элементов массива могут быть null.

getVoiceStatus

VoiceStatus[] getVoiceStatus()

Получает текущий статус речи, произведенной этим синтезатором. Если этот класс Synthesizer не предоставляет информацию о речи, возвращенный массив будет всегда иметь длину 0. Иначе, его длина всегда равна общему количеству речи, как возвращено getMaxPolyphony(). (См. VoiceStatus описание класса для объяснения речи синтезатора.)

Возвраты:

массив VoiceStatus объекты, которые предоставляют информацию о соответствующей речи синтезатора

См. Также:

getMaxPolyphony(), VoiceStatus

isSoundbankSupported

boolean isSoundbankSupported(Soundbank soundbank)

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

Параметры:

soundbank - soundbank, для которого запрашивается поддержка

Возвраты:

true если soundbank поддерживается, иначе false

См. Также:

loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]), loadAllInstruments(javax.sound.midi.Soundbank), unloadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]), unloadAllInstruments(javax.sound.midi.Soundbank), getDefaultSoundbank()

loadInstrument

boolean loadInstrument(Instrument instrument)

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

Инструмент должен быть частью soundbank что это Synthesizer поддерживает. (Чтобы удостовериться, можно использовать getSoundbank метод Instrument и isSoundbankSupported метод Synthesizer.)

Параметры:

instrument - инструмент, чтобы загрузиться

Возвраты:

true если инструмент успешно загружается (или уже был), false если инструмент не мог бы быть загружен (например, если у синтезатора есть недостаточная память, чтобы загрузить его),

Броски:

IllegalArgumentException - если это Synthesizer не поддерживает soundbank указанного инструмента

См. Также:

unloadInstrument(javax.sound.midi.Instrument), loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]), loadAllInstruments(javax.sound.midi.Soundbank), remapInstrument(javax.sound.midi.Instrument, javax.sound.midi.Instrument), SoundbankResource.getSoundbank(), MidiChannel.programChange(int, int)

unloadInstrument

void unloadInstrument(Instrument instrument)

Разгружает определенный инструмент.

Параметры:

instrument - инструмент, чтобы разгрузиться

Броски:

IllegalArgumentException - если это Synthesizer не поддерживает soundbank указанного инструмента

См. Также:

loadInstrument(javax.sound.midi.Instrument), unloadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]), unloadAllInstruments(javax.sound.midi.Soundbank), getLoadedInstruments(), remapInstrument(javax.sound.midi.Instrument, javax.sound.midi.Instrument)

remapInstrument

boolean remapInstrument(Instrument from,
                      Instrument to)

Повторно отображает инструмент. Инструмент to берет место инструмента from.
Например, если from был расположен в банке номер 2, программа номер 11, повторно отображая причины что банк и расположение программы, которое будет занято вместо этого to.
Если функция успешно выполняется, инструмент from разгружается.

Отменять повторно отображающийся инструмент перезагрузки from вызывая один из loadInstrument(javax.sound.midi.Instrument), loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]) или loadAllInstruments(javax.sound.midi.Soundbank).

Параметры:

from - Instrument объект, который будет заменен

to - Instrument объект, который будет использоваться вместо старого инструмента, это должно быть загружено в синтезатор

Возвраты:

true если инструмент succeessfully повторно отображенный, false если опция не реализуется синтезатором

Броски:

IllegalArgumentException - если инструмент from или инструмент to не поддерживаются синтезатором или если инструмент to не загружается

NullPointerException - если from или to у параметров есть нулевое значение

См. Также:

loadInstrument(javax.sound.midi.Instrument), loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]), loadAllInstruments(javax.sound.midi.Soundbank)

getDefaultSoundbank

Soundbank getDefaultSoundbank()

Получает значение по умолчанию soundbank для синтезатора, если Вы существуете. (Некоторые синтезаторы обеспечивают значение по умолчанию или встроенный soundbank.), Если у синтезатора нет значения по умолчанию soundbank, инструменты должны быть загружены явно из внешнего soundbank.

Возвраты:

значение по умолчанию soundbank, или null если Вы не существуете.

См. Также:

isSoundbankSupported(javax.sound.midi.Soundbank)

getAvailableInstruments

Instrument[] getAvailableInstruments()

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

Отметьте, что Вы не используете этот метод, чтобы узнать, какие инструменты в настоящий момент загружаются на синтезатор; с этой целью Вы используете getLoadedInstruments(). И при этом метод не указывает на все инструменты, которые могут быть загружены на синтезатор; это только указывает на подмножество, которые идут с синтезатором. Чтобы учиться, может ли другой инструмент быть загружен, можно вызвать isSoundbankSupported(), и если инструмент Soundbank поддерживается, можно попытаться загрузить инструмент.

Возвраты:

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

См. Также:

getLoadedInstruments(), isSoundbankSupported(Soundbank), loadInstrument(javax.sound.midi.Instrument)

getLoadedInstruments

Instrument[] getLoadedInstruments()

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

Возвраты:

список в настоящий момент загруженных инструментов

См. Также:

loadInstrument(javax.sound.midi.Instrument), getAvailableInstruments(), Soundbank.getInstruments()

loadAllInstruments

boolean loadAllInstruments(Soundbank soundbank)

Загрузки на Synthesizer все инструменты содержатся в указанном Soundbank.

Параметры:

soundbank - Soundbank чей инструменты, должны быть загружены

Возвраты:

true если инструменты все успешно загружаются (или уже был), false если какой-либо инструмент не мог бы быть загружен (например, если Synthesizer имел недостаточную память),

Броски:

IllegalArgumentException - если требуемый soundbank является несовместимым с этим синтезатором.

См. Также:

isSoundbankSupported(javax.sound.midi.Soundbank), loadInstrument(javax.sound.midi.Instrument), loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[])

unloadAllInstruments

void unloadAllInstruments(Soundbank soundbank)

Разгружает все инструменты, содержавшиеся в указанном Soundbank.

Параметры:

soundbank - soundbank, содержащий инструменты, чтобы разгрузиться

Броски:

IllegalArgumentException - брошенный, если soundbank не поддерживается.

См. Также:

isSoundbankSupported(javax.sound.midi.Soundbank), unloadInstrument(javax.sound.midi.Instrument), unloadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[])

loadInstruments

boolean loadInstruments(Soundbank soundbank,
                      Patch[] patchList)

Загружает инструменты, на которые ссылаются указанные патчи, от указанного Soundbank. Каждый из Patch объекты указывают на банк и число программы; Instrument у этого есть соответствие Patch загружается в тот банк и расположение программы.

Параметры:

soundbank - Soundbank содержа инструменты, чтобы загрузиться

patchList - список патчей, для которых должны быть загружены инструменты

Возвраты:

true если инструменты все успешно загружаются (или уже был), false если какой-либо инструмент не мог бы быть загружен (например, если Synthesizer имел недостаточную память),

Броски:

IllegalArgumentException - брошенный, если soundbank не поддерживается.

См. Также:

isSoundbankSupported(javax.sound.midi.Soundbank), Instrument.getPatch(), loadAllInstruments(javax.sound.midi.Soundbank), loadInstrument(javax.sound.midi.Instrument), Soundbank.getInstrument(Patch), Sequence.getPatchList()

unloadInstruments

void unloadInstruments(Soundbank soundbank,
                     Patch[] patchList)

Разгружает инструменты, на которые ссылаются указанные патчи, от определенного банка звуков MIDI.

Параметры:

soundbank - soundbank, содержащий инструменты, чтобы разгрузиться

patchList - список патчей, для которых должны быть разгружены инструменты

Броски:

IllegalArgumentException - брошенный, если soundbank не поддерживается.

См. Также:

unloadInstrument(javax.sound.midi.Instrument), unloadAllInstruments(javax.sound.midi.Soundbank), isSoundbankSupported(javax.sound.midi.Soundbank), Instrument.getPatch(), loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[])