Top Description Methods
javax.sound.midi

public Interface Receiver

extends AutoCloseable
Known Direct Subinterfaces
javax.sound.midi.MidiDeviceReceiver

A Receiver receives MidiEvent objects and typically does something useful in response, such as interpreting them to generate sound or raw MIDI output. Common MIDI receivers include synthesizers and MIDI Out ports.
Author
Kara Kytle
See Also
MidiDevice, Synthesizer, Transmitter

Method Summary

Modifier and TypeMethod and Description
public void
close()

Redeclares java.lang.AutoCloseable.close.

Indicates that the application has finished using the receiver, and that limited resources it requires may be released or made available.
public void
send(MidiMessage
the MIDI message to send
message
,
long
the time-stamp for the message, in microseconds
timeStamp
)

Sends a MIDI message and time-stamp to this receiver.

Method Detail

closeback to summary
public void close()

Redeclares java.lang.AutoCloseable.close.

Indicates that the application has finished using the receiver, and that limited resources it requires may be released or made available.

If the creation of this Receiver resulted in implicitly opening the underlying device, the device is implicitly closed by this method. This is true unless the device is kept open by other Receiver or Transmitter instances that opened the device implicitly, and unless the device has been opened explicitly. If the device this Receiver is retrieved from is closed explicitly by calling MidiDevice.close, the Receiver is closed, too. For a detailed description of open/close behaviour see the class description of MidiDevice.

Annotations
@Override
See Also
MidiSystem#getReceiver
sendback to summary
public void send(MidiMessage message, long timeStamp)

Sends a MIDI message and time-stamp to this receiver. If time-stamping is not supported by this receiver, the time-stamp value should be -1.

Parameters
message:MidiMessage

the MIDI message to send

timeStamp:long

the time-stamp for the message, in microseconds

Exceptions
IllegalStateException:
if the receiver is closed