javax.sound.midi

Интерфейс MidiDevice

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

AutoCloseable

Все Известные Подынтерфейсы:

Секвенсер, Синтезатор

public interface MidiDevice
extends AutoCloseable

MidiDevice основной интерфейс для всех MIDI-устройств. Общие устройства включают синтезаторы, секвенсеры, входные порты MIDI, и выходные порты MIDI.

A MidiDevice может быть передатчик или получатель событий MIDI, или обоих. Поэтому, это может обеспечить Transmitter или Receiver экземпляры (или оба). Как правило, MIDI В портах обеспечивает передатчики, MIDI, порты и синтезаторы обеспечивают получатели. Секвенсер обычно обеспечивает передатчики для воспроизведения и получатели для того, чтобы записать.

A MidiDevice может быть открыт и закрыт явно так же как неявно. Явное открытие выполняется, вызывая open(), явное закрытие делается, вызывая close() на MidiDevice экземпляр. Если приложение открывает a MidiDevice явно, это должно закрыть это явно, чтобы освободить системные ресурсы и позволить приложению выйти чисто. Неявное открытие делается, вызывая MidiSystem.getReceiver и MidiSystem.getTransmitter. MidiDevice используемый MidiSystem.getReceiver и MidiSystem.getTransmitter не иждивенец реализации если свойства javax.sound.midi.Receiver и javax.sound.midi.Transmitter используются (см. описание свойств, чтобы выбрать провайдеров значения по умолчанию в MidiSystem). A MidiDevice это было открыто неявно, закрывается неявно, закрываясь Receiver или Transmitter это привело к открытию этого. Если больше чем одно неявно открытие Receiver или Transmitter были получены приложением, decive закрывается после последнего Receiver или Transmitter был закрыт. С другой стороны, вызов getReceiver или getTransmitter на экземпляре устройства непосредственно не открывает устройство неявно. Закрытие их Transmitters и Receivers не закрывает устройство неявно. Использовать устройство с Receivers или Transmitters получил этот путь, устройство должно быть открыто и закрыто явно.

Если неявное и явное открытие и закрытие смешиваются на том же самом MidiDevice экземпляр, следующие правила применяются:

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

Чтобы обнаружить, если MidiDevice представляет аппаратный порт MIDI, следующий метод программирования может использоваться:

 MidiDevice device = ...;
 if ( ! (device instanceof Sequencer) && ! (device instanceof Synthesizer)) {
   // we're now sure that device represents a MIDI port
   // ...
 }
 

A MidiDevice включает a MidiDevice.Info объект предоставить информацию о производителе и так далее.

См. Также:

Synthesizer, Sequencer, Receiver, Transmitter

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

Вложенные Классы

Модификатор и Тип	Интерфейс и Описание
static class	MidiDevice. Информация A MidiDevice.Info объект содержит различные данные о a MidiDevice, включая ее имя, компания, которая создала это, и дескриптивный текст.

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

Модификатор и Тип	Метод и Описание
void	close() Закрывает устройство, указывая, что устройство должно теперь выпустить любые системные ресурсы, которые это использует.
MidiDevice. Информация	getDeviceInfo() Получает информацию об устройстве, включая его Java class и Strings содержа его имя, поставщика, и описание.
int	getMaxReceivers() Получает максимальное количество MIDI В соединениях, доступных на этом MIDI-устройстве для того, чтобы получить данные MIDI.
int	getMaxTransmitters() Получает максимальное количество MIDI соединения, доступные на этом MIDI-устройстве для того, чтобы передать данные MIDI.
long	getMicrosecondPosition() Получает текущую метку времени устройства, в микросекундах.
Получатель	getReceiver() Получает MIDI В получателе, через который MIDI-устройство может получить данные MIDI.
List<Receiver>	getReceivers() Возвраты все в настоящий момент активные, незакрытые получатели соединялись с этим MidiDevice.
Передатчик	getTransmitter() Получает MIDI соединение, от которого MIDI-устройство передаст данные MIDI, возвращенный передатчик должен быть закрыт, когда приложение закончило использовать это.
List<Transmitter>	getTransmitters() Возвраты все в настоящий момент активные, незакрытые передатчики соединялись с этим MidiDevice.
boolean	isOpen() Отчеты, открыто ли устройство.
void	open() Открывает устройство, указывая, что оно должно теперь получить любые системные ресурсы, которых оно требует, и станьте операционными.

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

getDeviceInfo

MidiDevice.Info getDeviceInfo()

Получает информацию об устройстве, включая его Java class и Strings содержа его имя, поставщика, и описание.

Возвраты:

информация устройства

открытый

void open()
   throws MidiUnavailableException

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

Приложение, открывающее устройство явно с этим вызовом, должно закрыть устройство, вызывая close(). Это необходимо, чтобы выпустить системные ресурсы и позволить приложениям выходить чисто.

Отметьте, что некоторые устройства, когда-то закрытые, не могут быть вновь открыты. Попытки вновь открыть такое устройство будут всегда приводить к MidiUnavailableException.

Броски:

MidiUnavailableException - брошенный, если устройство не может быть открыто из-за ограничений ресурса.

SecurityException - брошенный, если устройство не может быть открыто из-за ограничений безопасности.

См. Также:

close(), isOpen()

близко

void close()

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

Все Receiver и Transmitter закрываются экземпляры, открытые от этого устройства. Это включает экземпляры, полученные через MidiSystem.

Определенный:

close в интерфейсе AutoCloseable

См. Также:

open(), isOpen()

isOpen

boolean isOpen()

Отчеты, открыто ли устройство.

Возвраты:

true если устройство открыто, иначе false

См. Также:

open(), close()

getMicrosecondPosition

long getMicrosecondPosition()

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

Возвраты:

текущая метка времени устройства в микросекундах, или-1, если добавление метки времени не поддерживается устройством.

getMaxReceivers

int getMaxReceivers()

Получает максимальное количество MIDI В соединениях, доступных на этом MIDI-устройстве для того, чтобы получить данные MIDI.

Возвраты:

максимальное количество MIDI В соединениях, или-1, если неограниченное количество соединений доступно.

getMaxTransmitters

int getMaxTransmitters()

Получает максимальное количество MIDI соединения, доступные на этом MIDI-устройстве для того, чтобы передать данные MIDI.

Возвраты:

максимальное количество MIDI соединения, или-1, если неограниченное количество соединений доступно.

getReceiver

Receiver getReceiver()
              throws MidiUnavailableException

Получает MIDI В получателе, через который MIDI-устройство может получить данные MIDI. Возвращенный получатель должен быть закрыт, когда приложение закончило использовать его.

Обычно возвращенный получатель реализует MidiDeviceReceiver интерфейс.

Получение a Receiver с этим методом не открывает устройство. Чтобы быть в состоянии использовать устройство, это должно быть открыто явно, вызывая open(). Кроме того, закрытие Receiver не закрывает устройство. Это должно быть закрыто явно, вызывая close().

Возвраты:

получатель для устройства.

Броски:

MidiUnavailableException - брошенный, если получатель не доступен из-за ограничений ресурса

См. Также:

Receiver.close()

getReceivers

List<Receiver> getReceivers()

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

Обычно возвращенные получатели реализуют MidiDeviceReceiver интерфейс.

Возвраты:

неподдающийся изменению список открытых получателей

С тех пор:

1.5

getTransmitter

Transmitter getTransmitter()
                    throws MidiUnavailableException

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

Обычно возвращенный передатчик реализует MidiDeviceTransmitter интерфейс.

Получение a Transmitter с этим методом не открывает устройство. Чтобы быть в состоянии использовать устройство, это должно быть открыто явно, вызывая open(). Кроме того, закрытие Transmitter не закрывает устройство. Это должно быть закрыто явно, вызывая close().

Возвраты:

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

Броски:

MidiUnavailableException - брошенный, если передатчик не доступен из-за ограничений ресурса

См. Также:

Transmitter.close()

getTransmitters

List<Transmitter> getTransmitters()

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

Обычно возвращенные передатчики реализуют MidiDeviceTransmitter интерфейс.

Возвраты:

неподдающийся изменению список открытых передатчиков

С тех пор:

1.5