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