JavaTM 2 Platform
Standard Ed. 6

javax.sound.midi
接口 Receiver


public interface Receiver

一个 Receiver,用于接收 MidiEvent 对象,并且通常执行一些响应性的操作,例如,解释该对象以生成声音或原始 MIDI 输出。常见的 MIDI 接收器包括合成器和 MIDI Out 端口。

另请参见:
MidiDevice, Synthesizer, Transmitter

方法摘要
 void close()
          指示应用程序已结束使用接收器,以及其请求的受限制资源可能已被释放或已可用。
 void send(MidiMessage message, long timeStamp)
          向接收器发送一个 MIDI 消息和时间戳。
 

方法详细信息

send

void send(MidiMessage message,
          long timeStamp)
向接收器发送一个 MIDI 消息和时间戳。如果该接收器不支持时间戳,则该时间戳值应为 -1。

参数:
message - 要发送的 MIDI 消息
timeStamp - 消息的时间戳,以微秒为单位。
抛出:
IllegalStateException - 如果接收器关闭

close

void close()
指示应用程序已结束使用接收器,以及其请求的受限制资源可能已被释放或已可用。

如果创建此 Receiver 导致隐式打开底层设备,则该方法隐式关闭该设备。只有当设备由其他隐式打开该设备的 ReceiverTransmitter 实例保持打开,以及此设备已显式打开时才会出现这种情况。如果从其检索该 Receiver 的设备通过调用 MidiDevice.close 显式关闭,则 Receiver 也被关闭。有关打开/关闭行为的详细描述,请参见 MidiDevice 的类描述。

另请参见:
MidiSystem.getReceiver()

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策