MidiDevice (Java Platform SE 8 )

All Superinterfaces:

AutoCloseable

All Known Subinterfaces:

Sequencer ， Synthesizer
```
public interface MidiDevice
extends AutoCloseable
```
MidiDevice是所有MIDI设备的基础接口。常用设备包括合成器，音序器，MIDI输入端口和MIDI输出端口。
A MidiDevice可以是MIDI事件的发射器或接收器，或两者兼而有之。因此，它可以提供Transmitter或Receiver实例（或两者）。通常，MIDI IN端口提供发射器，MIDI OUT端口和合成器提供接收器。音序器通常提供用于播放的发射机和用于记录的接收机。

A MidiDevice可以明确地和MidiDevice地打开和关闭。明确开放是通过调用来完成open() ，明确关闭是通过调用close()上MidiDevice实例。如果一个应用程序显式地打开了一个MidiDevice ，它必须明确关闭它以释放系统资源，并使应用程序能够彻底地退出。隐性打开通过调用MidiSystem.getReceiver和MidiSystem.getTransmitter完成。所述MidiDevice通过使用MidiSystem.getReceiver和MidiSystem.getTransmitter是依赖于实现的，除非属性javax.sound.midi.Receiver和javax.sound.midi.Transmitter被使用（见属性的描述中，选择默认提供MidiSystem ）。 MidiDevice地打开的MidiDevice隐藏地关闭导致打开它的Receiver或Transmitter 。如果应用程序获得多于一个隐式打开Receiver或Transmitter ，则设备在最后一个Receiver或Transmitter关闭后关闭。另一方面，直接在设备实例上调用getReceiver或getTransmitter不会隐式打开设备。关闭这些Transmitter和Receiver s不会Receiver关闭设备。要使用具有Receiver s或Transmitter s的设备，必须明确地打开和关闭该设备。

如果隐含和明确的打开和关闭在同一个MidiDevice实例上混合，则适用以下规则：
- 在显式打开（隐式打开之前或之后）时，设备将不会被隐式关闭关闭。关闭显式打开的设备的唯一方法是显式关闭。
- 显式关闭始终关闭设备，即使它也已隐式打开。随后的隐含关系没有进一步的影响。
要检测MidiDevice是否代表硬件MIDI端口，可以使用以下编程技术：
```
   MidiDevice device = ...; if ( ! (device instanceof Sequencer) && ! (device instanceof Synthesizer)) { // we're now sure that device represents a MIDI port // ... }  
```
A MidiDevice包括一个MidiDevice.Info对象来提供制造商信息等。
另请参见：

Synthesizer ， Sequencer ， Receiver ， Transmitter

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`MidiDevice.Info` 一个 `MidiDevice.Info`对象包含有关 `MidiDevice`各种数据，包括其名称，创建它的公司和描述性文本。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`close()` 关闭设备，指示设备现在应该释放它正在使用的任何系统资源。
`MidiDevice.Info`	`getDeviceInfo()` 获得关于设备，包括它的Java类和信息 `Strings`包含其名称，供应商和描述。
`int`	`getMaxReceivers()` 获取此MIDI设备上可用于接收MIDI数据的MIDI IN连接的最大数量。
`int`	`getMaxTransmitters()` 获取此MIDI设备上可用于发送MIDI数据的MIDI OUT连接的最大数量。
`long`	`getMicrosecondPosition()` 获取设备的当前时间戳，以微秒为单位。
`Receiver`	`getReceiver()` 获取MIDI IN接收器，MIDI设备可以通过MIDI接收器接收MIDI数据。
`List<Receiver>`	`getReceivers()` 返回与此MidiDevice连接的所有当前活动的非闭合接收器。
`Transmitter`	`getTransmitter()` 获取MIDI输出连接，MIDI设备将从MIDI连接传输MIDI数据当应用程序完成使用后，返回的发送器必须关闭。
`List<Transmitter>`	`getTransmitters()` 返回与此MidiDevice连接的所有当前有效的非闭合发射器。
`boolean`	`isOpen()` 报告设备是否打开。
`void`	`open()` 打开设备，表明它现在应该获得所需的任何系统资源并可以运行。

- 方法详细信息
  - getDeviceInfo
```
MidiDevice.Info getDeviceInfo()
```
    获得关于设备，包括它的Java类和信息 Strings包含其名称，供应商和描述。
    
    结果
    
    设备信息
  - open
```
void open()
   throws MidiUnavailableException
```
    打开设备，表明它现在应该获得所需的任何系统资源并可以运行。
    通过此呼叫显式打开设备的应用程序必须通过调用close()关闭设备。这是释放系统资源和允许应用程序彻底退出的必要条件。
    
    请注意，一旦关闭，某些设备无法重新打开。尝试重新打开此类设备将始终导致MidiUnavailableException。
    
    异常
    
    MidiUnavailableException - 由于资源限制，设备无法打开时抛出。
    
    SecurityException - 由于安全限制，设备无法打开时抛出。
    
    另请参见：
    
    close() ， isOpen()
  - close
```
void close()
```
    关闭设备，指示设备现在应该释放它正在使用的任何系统资源。
    所有Receiver设备打开的Receiver和Transmitter实例都已关闭。这包括通过MidiSystem 。
    
    Specified by:
    
    close在界面 AutoCloseable
    
    另请参见：
    
    open() ， isOpen()
  - isOpen
```
boolean isOpen()
```
    报告设备是否打开。
    
    结果
    
    true如果设备打开，否则为 false
    
    另请参见：
    
    open() ， close()
  - getMicrosecondPosition
```
long getMicrosecondPosition()
```
    获取设备的当前时间戳，以微秒为单位。如果设备支持时间戳，则在设备打开时应开始计数，并继续递增其时间戳，以微秒为单位，直到设备关闭。如果不支持时间戳，则应始终返回-1。
    
    结果
    
    设备的当前时间戳（以微秒为单位），如果设备不支持时间戳，则为-1。
  - getMaxReceivers
```
int getMaxReceivers()
```
    获取此MIDI设备上可用于接收MIDI数据的MIDI IN连接的最大数量。
    
    结果
    
    MIDI IN连接的最大数量，如果无限数量的连接可用，则为-1。
  - getMaxTransmitters
```
int getMaxTransmitters()
```
    获取此MIDI设备上可用于发送MIDI数据的MIDI OUT连接的最大数量。
    
    结果
    
    MIDI OUT连接的最大数量，如果无限数量的连接可用，则为-1。
  - getReceiver
```
Receiver getReceiver()
              throws MidiUnavailableException
```
    获取MIDI IN接收器，MIDI设备可以通过MIDI接收器接收MIDI数据。当应用程序完成使用后，返回的接收方必须关闭。
    通常返回的接收器实现MidiDeviceReceiver接口。
    
    使用此方法Receiver不会打开设备。为了能够使用该设备，必须通过调用open()显式地打开。另外关闭Receiver也不会关闭设备。它必须通过调用close()显式关闭。
    
    结果
    
    该设备的接收器。
    
    异常
    
    MidiUnavailableException - 由于资源限制，如果接收器不可用，则抛出
    
    另请参见：
    
    Receiver.close()
  - getReceivers
```
List<Receiver> getReceivers()
```
    返回与此MidiDevice连接的所有当前活动的非闭合接收器。通过关闭接收器可以从设备中移除。
    通常返回的接收器实现MidiDeviceReceiver接口。
    
    结果
    
    一个不可修改的开放式接收器列表
    
    从以下版本开始：
    
    1.5
  - getTransmitter
```
Transmitter getTransmitter()
                    throws MidiUnavailableException
```
    获取MIDI输出连接，MIDI设备将从MIDI连接传输MIDI数据当应用程序完成使用后，返回的发送器必须关闭。
    通常返回的发射机实现MidiDeviceTransmitter接口。
    
    使用此方法Transmitter不会打开设备。为了能够使用该设备，必须通过调用open()明确打开该设备。此外，关闭Transmitter不关闭设备。它必须通过调用close()显式关闭。
    
    结果
    
    用于设备的MIDI OUT发射器。
    
    异常
    
    MidiUnavailableException - 由于资源限制，如果 MidiUnavailableException ，则抛出
    
    另请参见：
    
    Transmitter.close()
  - getTransmitters
```
List<Transmitter> getTransmitters()
```
    返回与此MidiDevice连接的所有当前有效的非闭合发射器。通过关闭变送器可以将其从设备中取出。
    通常返回的发射机实现MidiDeviceTransmitter接口。
    
    结果
    
    一个不可修改的开放式发射机列表
    
    从以下版本开始：
    
    1.5

Interface MidiDevice

Nested Class Summary

方法摘要

方法详细信息

getDeviceInfo

open

close

isOpen

getMicrosecondPosition

getMaxReceivers

getMaxTransmitters

getReceiver

getReceivers

getTransmitter

getTransmitters