Interface Receiver
-
- All Superinterfaces:
- AutoCloseable
- All Known Subinterfaces:
- MidiDeviceReceiver
public interface Receiver extends AutoCloseable
AReceiver
receives
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.MidiEvent
- See Also:
-
MidiDevice
,Synthesizer
,Transmitter
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description void
close()
Indicates that the application has finished using the receiver, and that limited resources it requires may be released or made available.void
send(MidiMessage message, long timeStamp)
Sends a MIDI message and time-stamp to this receiver.
-
-
-
Method Detail
send
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
- the MIDI message to send -
timeStamp
- the time-stamp for the message, in microseconds. - Throws:
-
IllegalStateException
- if the receiver is closed
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 otherReceiver
orTransmitter
instances that opened the device implicitly, and unless the device has been opened explicitly. If the device thisReceiver
is retrieved from is closed explicitly by callingMidiDevice.close
, theReceiver
is closed, too. For a detailed description of open/close behaviour see the class description ofMidiDevice
.- Specified by:
-
close
in interfaceAutoCloseable
- See Also:
-
MidiSystem.getReceiver()
-
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, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.