Интерфейс MidiDevice

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

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

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

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

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

Объект MidiDevice содержит объект MidiDevice.Info для предоставления информации о производителе и т. д.