javax.sound.midi
Interface Receiver


public interface Receiver

A Receiver receives MidiEvent sample code for javax.sound.midi.MidiEvent definition code for javax.sound.midi.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.

See Also:
MidiDevice sample code for javax.sound.midi.MidiDevice definition code for javax.sound.midi.MidiDevice , Synthesizer sample code for javax.sound.midi.Synthesizer definition code for javax.sound.midi.Synthesizer , Transmitter sample code for javax.sound.midi.Transmitter definition code for javax.sound.midi.Transmitter

Method Summary
 void close sample code for javax.sound.midi.Receiver.close() definition code for javax.sound.midi.Receiver.close() ()
          Indicates that the application has finished using the receiver, and that limited resources it requires may be released or made available.
 void send sample code for javax.sound.midi.Receiver.send(javax.sound.midi.MidiMessage, long) definition code for javax.sound.midi.Receiver.send(javax.sound.midi.MidiMessage, long) (MidiMessage sample code for javax.sound.midi.MidiMessage definition code for javax.sound.midi.MidiMessage  message, long timeStamp)
          Sends a MIDI message and time-stamp to this receiver.
 

Method Detail

send sample code for javax.sound.midi.Receiver.send(javax.sound.midi.MidiMessage, long) definition code for javax.sound.midi.Receiver.send(javax.sound.midi.MidiMessage, long)

void send(MidiMessage sample code for javax.sound.midi.MidiMessage definition code for javax.sound.midi.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 - the MIDI message to send
timeStamp - the time-stamp for the message, in microseconds.
Throws:
IllegalStateException sample code for java.lang.IllegalStateException definition code for java.lang.IllegalStateException - if the receiver is closed

close sample code for javax.sound.midi.Receiver.close() definition code for javax.sound.midi.Receiver.close()

void 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 sample code for javax.sound.midi.MidiDevice.close() definition code for javax.sound.midi.MidiDevice.close() , the Receiver is closed, too. For a detailed description of open/close behaviour see the class description of MidiDevice sample code for javax.sound.midi.MidiDevice definition code for javax.sound.midi.MidiDevice .

See Also:
MidiSystem.getReceiver() sample code for javax.sound.midi.MidiSystem.getReceiver() definition code for javax.sound.midi.MidiSystem.getReceiver()