Интерфейс MidiDevice

public interface MidiDevice
extends AutoCloseable

MidiDevice — это базовый интерфейс для всех устройств MIDI. К распространённым устройствам относятся синтезаторы, секвенсоры, порты ввода MIDI и порты вывода MIDI.

Устройство 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 аппаратный порт MIDI, можно использовать следующий приём программирования:

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

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