Интерфейс MidiDevice

MidiDevice может быть передатчиком или приёмником MIDI-событий либо выполнять обе функции. Поэтому он может предоставлять экземпляры Transmitter или Receiver (либо и те, и другие). Обычно порты MIDI IN предоставляют передатчики, а порты MIDI OUT и синтезаторы — приёмники. Секвенсор обычно предоставляет передатчики для воспроизведения и приёмники для записи.

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, содержащий сведения о производителе и другую информацию.