MidiDevice (Java Platform SE 8 )

All Superinterfaces:

AutoCloseable

All Known Subinterfaces:

Sequencer， Synthesizer
```
public interface MidiDevice
extends AutoCloseable
```
MidiDevice是所有MIDI设备底座接口。常见的设备包括合成器，音序器，MIDI输入端口，和MIDI输出端口。
一个MidiDevice可以发射机或MIDI事件接收器，或两者。因此，它可以提供Transmitter或Receiver实例（或两者）。通常，MIDI端口提供发射机、MIDI输出端口和合成器提供接收机。一个音序器通常提供了用于记录回放和接收器发射器。

一个MidiDevice可以打开和关闭以及隐式显式。通过调用显式打开open()完成的，明确的结束是在MidiDevice实例调用close()做。如果一个应用程序打开一个MidiDevice明确，它已关闭它明确地释放系统资源，使应用程序能够干净地退出。隐式的开放是通过调用MidiSystem.getReceiver和MidiSystem.getTransmitter做。通过MidiSystem.getReceiver和MidiSystem.getTransmitter用MidiDevice实现依赖除非性能javax.sound.midi.Receiver和javax.sound.midi.Transmitter使用（见属性选择默认供应商MidiSystem描述）。一个MidiDevice说开了含蓄，是通过关闭Receiver或Transmitter导致打开它隐式关闭。如果超过一个隐式的开放Receiver或Transmitter被应用，装置在最后Receiver或Transmitter已关闭。另一方面，呼叫getReceiver或getTransmitter对设备实例直接不打开设备隐。关闭这些Transmitters和Receivers不关闭设备隐。使用一个装置与Receivers或Transmitters这种方式获得的，该设备必须打开和关闭显。

如果隐式和显式打开和关闭混合在同一MidiDevice实例，适用以下规则：
- 在一个显式打开（无论是在隐式打开之前或之后），该设备将不会被隐式关闭。关闭一个显式打开的设备的唯一方法是一个显式关闭。
- 一个显式关闭总是关闭该设备，即使它也已被隐式打开。随后的隐式关闭没有进一步的效果。
检测如果mididevice代表一个硬件端口，下面的编程技术可用于：
```
 MidiDevice device = ...;
 if ( ! (device instanceof Sequencer) && ! (device instanceof Synthesizer)) {
   // we're now sure that device represents a MIDI port
   // ...
 }
 
```
一个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设备。
`int`	`getMaxTransmitters()` 获得最大数量的可用MIDI连接在MIDI设备发送MIDI数据。
`long`	`getMicrosecondPosition()` 获得该设备的当前时间戳，在微秒。
`Receiver`	`getReceiver()` 获得接收MIDI通过MIDI设备可以接收MIDI数据。
`List<Receiver>`	`getReceivers()` 返回所有当前活动的，非封闭连接这mididevice接收机。
`Transmitter`	`getTransmitter()` 得到一个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和Transmitter实例从这个设备打开关闭。这包括通过MidiSystem检索实例。
    
    Specified by:
    
    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接口。
    
    获得这个方法的Receiver不打开装置。能够使用的设备，它必须通过调用open()显式打开，关闭Receiver不会关闭装置。它必须通过调用close()显式关闭。
    
    结果
    
    用于设备的接收器。
    
    异常
    
    MidiUnavailableException -如果一个接收器不可用，由于资源的限制抛
    
    另请参见：
    
    Receiver.close()
  - getReceivers
```
List<Receiver> getReceivers()
```
    返回所有当前活动的，非封闭连接这mididevice接收机。一个接收器可以从设备中删除关闭它。
    通常返回的接收机实现MidiDeviceReceiver接口。
    
    结果
    
    打开接收机的一个不可修改的列表
    
    从以下版本开始：
    
    一点五
  - getTransmitter
```
Transmitter getTransmitter()
                    throws MidiUnavailableException
```
    得到一个MIDI连接的MIDI设备将发送MIDI数据返回的变送器必须关闭的时候使用它的应用程序已完成。
    通常返回的发射机实现MidiDeviceTransmitter接口。
    
    用这种方法获得Transmitter不打开装置。能够使用的设备，它必须通过调用open()显式打开。同时，关闭Transmitter不会关闭装置。它必须通过调用close()显式关闭。
    
    结果
    
    MIDI了发射机的装置。
    
    异常
    
    MidiUnavailableException如果发射机不可用，由于资源的限制抛
    
    另请参见：
    
    Transmitter.close()
  - getTransmitters
```
List<Transmitter> getTransmitters()
```
    返回所有当前活动的，非封闭连接这mididevice发射机。一个发射器可以从设备中关闭它。
    通常返回的发射机实现MidiDeviceTransmitter接口。
    
    结果
    
    打开发射机的一个不可修改的列表
    
    从以下版本开始：
    
    一点五

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface MidiDevice

Nested Class Summary

方法摘要

方法详细信息

getDeviceInfo

open

close

isOpen

getMicrosecondPosition

getMaxReceivers

getMaxTransmitters

getReceiver

getReceivers

getTransmitter

getTransmitters