Provides interfaces and classes for capture, processing, and playback of sampled audio data.
Related DocumentationFor more information on using Java Sound see:
nullreference 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.
NullPointerExceptionis an example of typical and acceptable run time exception for such cases.
Interface Summary Interface Description ClipThe
Clipinterface represents a special kind of data line whose audio data can be loaded prior to playback, instead of being streamed in real time.
DataLineadds media-related functionality to its superinterface,
Lineinterface represents a mono or multi-channel audio feed.
LineListenerInstances of classes that implement the
LineListenerinterface can register to receive events when a line's status changes.
MixerA mixer is an audio device with one or more lines. PortPorts are simple lines for input or output of audio to or from audio devices. SourceDataLineA source data line is a data line to which data may be written. TargetDataLineA target data line is a type of
DataLinefrom which audio data can be read.
Class Summary Class Description AudioFileFormatAn instance of the
AudioFileFormatclass describes an audio file, including the file type, the file's length in bytes, the length in sample frames of the audio data contained in the file, and the format of the audio data.
AudioFileFormat.TypeAn instance of the
Typeclass represents one of the standard types of audio file.
AudioFormatis the class that specifies a particular arrangement of data in a sound stream.
Encodingclass names the specific type of data representation used for an audio stream.
AudioInputStreamAn audio input stream is an input stream with a specified audio format and length. AudioPermissionThe
AudioPermissionclass represents access rights to the audio system resources.
AudioSystemclass acts as the entry point to the sampled-audio system resources.
BooleanControlprovides the ability to switch between two possible settings that affect a line's audio.
BooleanControl.TypeAn instance of the
BooleanControl.Typeclass identifies one kind of boolean control.
CompoundControl, such as a graphic equalizer, provides control over two or more related properties, each of which is itself represented as a
CompoundControl.TypeAn instance of the
CompoundControl.Typeinner class identifies one kind of compound control.
Linesoften have a set of controls, such as gain and pan, that affect the audio signal passing through the line.
Control.TypeAn instance of the
Typeclass represents the type of the control.
DataLine.InfoBesides the class information inherited from its superclass,
DataLine.Infoprovides additional information specific to data lines.
EnumControlprovides control over a set of discrete possible values, each represented by an object.
EnumControl.TypeAn instance of the
EnumControl.Typeinner class identifies one kind of enumerated control.
FloatControlobject provides control over a range of floating-point values.
FloatControl.TypeAn instance of the
FloatControl.Typeinner class identifies one kind of float control.
Line.Infoobject contains information about a line.
LineEventclass encapsulates information that a line sends its listeners whenever the line opens, closes, starts, or stops.
LineEvent.TypeThe LineEvent.Type inner class identifies what kind of event occurred on a line. Mixer.InfoThe
Mixer.Infoclass represents information about an audio mixer, including the product's name, version, and vendor, along with a textual description.
Line.Infowith additional information specific to ports, including the port's name and whether it is a source or a target for its mixer.
ReverbTypeclass provides methods for accessing various reverberation settings to be applied to an audio signal.
Exception Summary Exception Description LineUnavailableExceptionA
LineUnavailableExceptionis an exception indicating that a line cannot be opened because it is unavailable.
UnsupportedAudioFileExceptionis an exception indicating that an operation failed because a file did not contain valid data of a recognized file type and format.