Module java.desktop

Package javax.sound.midi

Provides interfaces and classes for I/O, sequencing, and synthesis of MIDI (Musical Instrument Digital Interface) data.

Related Documentation

For more information on using Java Sound see:

• The Java Sound Tutorial

Please note: In the javax.sound.midi APIs, a null reference parameter to methods is incorrect unless explicitly documented on the method as having a meaningful interpretation. Usage to the contrary is incorrect coding and may result in a run time exception either immediately or at some later time. NullPointerException is an example of typical and acceptable run time exception for such cases.

Since:

1.3

Interface Summary

Interface	Description
ControllerEventListener	The ControllerEventListener interface should be implemented by classes whose instances need to be notified when a Sequencer has processed a requested type of MIDI control-change event.
MetaEventListener	The MetaEventListener interface should be implemented by classes whose instances need to be notified when a Sequencer has processed a MetaMessage.
MidiChannel	A MidiChannel object represents a single MIDI channel.
MidiDevice	MidiDevice is the base interface for all MIDI devices.
MidiDeviceReceiver	MidiDeviceReceiver is a Receiver which represents a MIDI input connector of a MidiDevice (see MidiDevice.getReceiver()).
MidiDeviceTransmitter	MidiDeviceTransmitter is a Transmitter which represents a MIDI input connector of a MidiDevice (see MidiDevice.getTransmitter()).
Receiver	A Receiver receives MidiEvent objects and typically does something useful in response, such as interpreting them to generate sound or raw MIDI output.
Sequencer	A hardware or software device that plays back a MIDI sequence is known as a sequencer.
Soundbank	A Soundbank contains a set of Instruments that can be loaded into a Synthesizer.
Synthesizer	A Synthesizer generates sound.
Transmitter	A Transmitter sends MidiEvent objects to one or more Receivers.

Class Summary

Class	Description
Instrument	An instrument is a sound-synthesis algorithm with certain parameter settings, usually designed to emulate a specific real-world musical instrument or to achieve a specific sort of sound effect.
MetaMessage	A MetaMessage is a MidiMessage that is not meaningful to synthesizers, but that can be stored in a MIDI file and interpreted by a sequencer program.
MidiDevice.Info	A MidiDevice.Info object contains assorted data about a MidiDevice, including its name, the company who created it, and descriptive text.
MidiEvent	MIDI events contain a MIDI message and a corresponding time-stamp expressed in ticks, and can represent the MIDI event information stored in a MIDI file or a Sequence object.
MidiFileFormat	A MidiFileFormat object encapsulates a MIDI file's type, as well as its length and timing information.
MidiMessage	MidiMessage is the base class for MIDI messages.
MidiSystem	The MidiSystem class provides access to the installed MIDI system resources, including devices such as synthesizers, sequencers, and MIDI input and output ports.
Patch	A Patch object represents a location, on a MIDI synthesizer, into which a single instrument is stored (loaded).
Sequence	A Sequence is a data structure containing musical information (often an entire song or composition) that can be played back by a Sequencer object.
Sequencer.SyncMode	A SyncMode object represents one of the ways in which a MIDI sequencer's notion of time can be synchronized with a master or slave device.
ShortMessage	A ShortMessage contains a MIDI message that has at most two data bytes following its status byte.
SoundbankResource	A SoundbankResource represents any audio resource stored in a Soundbank.
SysexMessage	A SysexMessage object represents a MIDI system exclusive message.
Track	A MIDI track is an independent stream of MIDI events (time-stamped MIDI data) that can be stored along with other tracks in a standard MIDI file.
VoiceStatus	A VoiceStatus object contains information about the current status of one of the voices produced by a Synthesizer.

Exception Summary

Exception	Description
InvalidMidiDataException	An InvalidMidiDataException indicates that inappropriate MIDI data was encountered.
MidiUnavailableException	A MidiUnavailableException is thrown when a requested MIDI component cannot be opened or created because it is unavailable.