Интерфейс 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 для предоставления информации о производителе и т. д.