MidiDevice (Платформа Java SE 7)

Все Суперинтерфейсы:

AutoCloseable

Все Известные Подынтерфейсы:

Секвенсер, Синтезатор
```
public interface MidiDevice
extends AutoCloseable
```
MidiDevice основной интерфейс для всех устройств MIDI. Общие устройства включают синтезаторы, секвенсеры, входные порты MIDI, и выходные порты MIDI.
A MidiDevice может быть передатчик или получатель событий MIDI, или обоих. Поэтому, это может обеспечить Transmitter или Receiver экземпляры (или оба). Как правило, MIDI В портах обеспечивает передатчики, MIDI, порты и синтезаторы обеспечивают получатели. Секвенсер обычно обеспечивает передатчики для воспроизведения и получатели для того, чтобы записать.
A MidiDevice может быть открыт и закрыт явно так же как неявно. Явное открытие выполняется, вызывая open(), явное закрытие делается, вызывая close() на MidiDevice экземпляр. Если приложение открывает a MidiDevice явно, это должно закрыть это явно, чтобы освободить системные ресурсы и позволить приложению выйти чисто. Неявное открытие делается, вызывая MidiSystem.getReceiver и MidiSystem.getTransmitter. MidiDevice используемый MidiSystem.getReceiver и MidiSystem.getTransmitter не иждивенец реализации если свойства javax.sound.midi.Receiver и javax.sound.midi.Transmitter используются (см. описание свойств, чтобы выбрать провайдеров по умолчанию в MidiSystem). A MidiDevice это было открыто неявно, закрывается неявно, закрываясь Receiver или Transmitter это привело к открытию этого. Если больше чем одно неявно открытие Receiver или Transmitter были получены приложением, decive закрывается после последнего Receiver или Transmitter был закрыт. С другой стороны, вызов getReceiver или getTransmitter на экземпляре устройства непосредственно не открывает устройство неявно. Закрытие их Transmitters и Receivers не закрывает устройство неявно. Использовать устройство с Receivers или Transmitters получил этот путь, устройство должно быть открыто и закрыто явно.
Если неявное и явное открытие и закрытие смешиваются на том же самом MidiDevice экземпляр, следующие правила применяются:
- После явного открытого (или прежде или после неявный открывается), устройство не будет закрыто неявным закрытием. Единственным способом закрыть явно открытое устройство является явное завершение.
- Явное завершение всегда закрывает устройство, даже если это также было открыто неявно. Последующее неявное завершение не имеет никакого дальнейшего эффекта.
Чтобы обнаружить, если MidiDevice представляет аппаратный порт MIDI, следующий метод программирования может использоваться:
```
 MidiDevice device = ...;
 if ( ! (device instanceof Sequencer) && ! (device instanceof Synthesizer)) {
   // we're now sure that device represents a MIDI port
   // ...
 }
 
```
A MidiDevice включает a MidiDevice.Info объект предоставить информацию о производителе и так далее.
См. Также:
Synthesizer, Sequencer, Receiver, Transmitter

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Интерфейс и Описание
`static class`	`MidiDevice. Информация` A `MidiDevice.Info` объект содержит различные данные о a `MidiDevice`, включая ее имя, компания, которая создала это, и дескриптивный текст.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`close()` Закрывает устройство, указывая, что устройство должно теперь выпустить любые системные ресурсы, которые это использует.
`MidiDevice. Информация`	`getDeviceInfo()` Получает информацию об устройстве, включая его класс Java и `Strings` содержа его имя, поставщика, и описание.
`int`	`getMaxReceivers()` Получает максимальное количество MIDI В соединениях, доступных на этом устройстве MIDI для того, чтобы получить данные MIDI.
`int`	`getMaxTransmitters()` Получает максимальное количество MIDI соединения, доступные на этом устройстве MIDI для того, чтобы передать данные MIDI.
`long`	`getMicrosecondPosition()` Получает текущую метку времени устройства, в микросекундах.
`Получатель`	`getReceiver()` Получает MIDI В получателе, через который устройство MIDI может получить данные MIDI.
`List<Receiver>`	`getReceivers()` Возвраты все в настоящий момент активные, незакрытые получатели соединялись с этим MidiDevice.
`Передатчик`	`getTransmitter()` Получает MIDI соединение, от которого устройство MIDI передаст данные MIDI, возвращенный передатчик должен быть закрыт, когда приложение закончило использовать это.
`List<Transmitter>`	`getTransmitters()` Возвраты все в настоящий момент активные, незакрытые передатчики соединялись с этим MidiDevice.
`boolean`	`isOpen()` Отчеты, открыто ли устройство.
`void`	`open()` Открывает устройство, указывая, что оно должно теперь получить любые системные ресурсы, которых оно требует, и станьте операционными.

- Деталь метода
  - getDeviceInfo
```
MidiDevice.Info getDeviceInfo()
```
    Получает информацию об устройстве, включая его класс Java и Strings содержа его имя, поставщика, и описание.
    
    Возвраты:
    информация устройства
  - открытый
```
void open()
          throws MidiUnavailableException
```
    Открывает устройство, указывая, что оно должно теперь получить любые системные ресурсы, которых оно требует, и станьте операционными.
    Приложение, открывающее устройство явно с этим вызовом, должно закрыть устройство, вызывая close(). Это необходимо, чтобы выпустить системные ресурсы и позволить приложениям выходить чисто.
    Отметьте, что некоторые устройства, когда-то закрытые, не могут быть вновь открыты. Попытки вновь открыть такое устройство будут всегда приводить к MidiUnavailableException.
    
    Броски:
    
    MidiUnavailableException - брошенный, если устройство не может быть открыто из-за ограничений ресурса.
    
    SecurityException - брошенный, если устройство не может быть открыто из-за ограничений безопасности.
    См. Также:
    close(), isOpen()
  - близко
```
void close()
```
    Закрывает устройство, указывая, что устройство должно теперь выпустить любые системные ресурсы, которые это использует.
    Все Receiver и Transmitter закрываются экземпляры, открытые от этого устройства. Это включает экземпляры, полученные через MidiSystem.
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    См. Также:
    open(), isOpen()
  - isOpen
```
boolean isOpen()
```
    Отчеты, открыто ли устройство.
    
    Возвраты:
    true если устройство открыто, иначе false
    См. Также:
    open(), close()
  - getMicrosecondPosition
```
long getMicrosecondPosition()
```
    Получает текущую метку времени устройства, в микросекундах. Если устройство поддерживает метки времени, оно должно начать рассчитывать в 0, когда устройство открывается, и продолжайте постепенно увеличивать его метку времени в микросекундах, пока устройство не закрывается. Если это не поддерживает метки времени, это должно всегда возвращаться-1.
    
    Возвраты:
    текущая метка времени устройства в микросекундах, или-1, если добавление метки времени не поддерживается устройством.
  - getMaxReceivers
```
int getMaxReceivers()
```
    Получает максимальное количество MIDI В соединениях, доступных на этом устройстве MIDI для того, чтобы получить данные MIDI.
    
    Возвраты:
    максимальное количество MIDI В соединениях, или-1, если неограниченное количество соединений доступно.
  - getMaxTransmitters
```
int getMaxTransmitters()
```
    Получает максимальное количество MIDI соединения, доступные на этом устройстве MIDI для того, чтобы передать данные MIDI.
    
    Возвраты:
    максимальное количество MIDI соединения, или-1, если неограниченное количество соединений доступно.
  - getReceiver
```
Receiver getReceiver()
                     throws MidiUnavailableException
```
    Получает MIDI В получателе, через который устройство MIDI может получить данные MIDI. Возвращенный получатель должен быть закрыт, когда приложение закончило использовать его.
    Обычно возвращенный получатель реализует MidiDeviceReceiver интерфейс.
    Получение a Receiver с этим методом не открывает устройство. Чтобы быть в состоянии использовать устройство, это должно быть открыто явно, вызывая open(). Кроме того, закрытие Receiver не закрывает устройство. Это должно быть закрыто явно, вызывая close().
    
    Возвраты:
    получатель для устройства.
    
    Броски:
    
    MidiUnavailableException - брошенный, если получатель не доступен из-за ограничений ресурса
    См. Также:
    Receiver.close()
  - getReceivers
```
List<Receiver> getReceivers()
```
    Возвраты все в настоящий момент активные, незакрытые получатели соединялись с этим MidiDevice. Получатель может быть удален из устройства, закрывая это.
    Обычно возвращенные получатели реализуют MidiDeviceReceiver интерфейс.
    
    Возвраты:
    неподдающийся изменению список открытых получателей
    С тех пор:
    
    1.5
  - getTransmitter
```
Transmitter getTransmitter()
                           throws MidiUnavailableException
```
    Получает MIDI соединение, от которого устройство MIDI передаст данные MIDI, возвращенный передатчик должен быть закрыт, когда приложение закончило использовать это.
    Обычно возвращенный передатчик реализует MidiDeviceTransmitter интерфейс.
    Получение a Transmitter с этим методом не открывает устройство. Чтобы быть в состоянии использовать устройство, это должно быть открыто явно, вызывая open(). Кроме того, закрытие Transmitter не закрывает устройство. Это должно быть закрыто явно, вызывая close().
    
    Возвраты:
    MIDI передатчик для устройства.
    
    Броски:
    
    MidiUnavailableException - брошенный, если передатчик не доступен из-за ограничений ресурса
    См. Также:
    Transmitter.close()
  - getTransmitters
```
List<Transmitter> getTransmitters()
```
    Возвраты все в настоящий момент активные, незакрытые передатчики соединялись с этим MidiDevice. Передатчик может быть удален из устройства, закрывая это.
    Обычно возвращенные передатчики реализуют MidiDeviceTransmitter интерфейс.
    
    Возвраты:
    неподдающийся изменению список открытых передатчиков
    С тех пор:
    
    1.5

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный MidiDevice

Вложенная Сводка Класса

Сводка метода

Деталь метода

getDeviceInfo

открытый

близко

isOpen

getMicrosecondPosition

getMaxReceivers

getMaxTransmitters

getReceiver

getReceivers

getTransmitter

getTransmitters