Package javax.sound.sampled
package javax.sound.sampled
Provides interfaces and classes for capture, processing, and playback of
sampled audio data.
Related Documentation
For more information on using Java Sound see: Please note: In thejavax.sound.sampled 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
-
ClassDescriptionAn 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.An instance of theTypeclass represents one of the standard types of audio file.AudioFormatis the class that specifies a particular arrangement of data in a sound stream.TheEncodingclass names the specific type of data representation used for an audio stream.An audio input stream is an input stream with a specified audio format and length.Deprecated, for removal: This API element is subject to removal in a future version.There is no replacement for this class.TheAudioSystemclass acts as the entry point to the sampled-audio system resources.ABooleanControlprovides the ability to switch between two possible settings that affect a line's audio.An instance of theBooleanControl.Typeclass identifies one kind of boolean control.TheClipinterface represents a special kind of data line whose audio data can be loaded prior to playback, instead of being streamed in real time.ACompoundControl, such as a graphic equalizer, provides control over two or more related properties, each of which is itself represented as aControl.An instance of theCompoundControl.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.An instance of theTypeclass represents the type of the control.DataLineadds media-related functionality to its superinterface,Line.Besides the class information inherited from its superclass,DataLine.Infoprovides additional information specific to data lines.AnEnumControlprovides control over a set of discrete possible values, each represented by an object.An instance of theEnumControl.Typeinner class identifies one kind of enumerated control.AFloatControlobject provides control over a range of floating-point values.An instance of theFloatControl.Typeinner class identifies one kind of float control.TheLineinterface represents a mono or multi-channel audio feed.ALine.Infoobject contains information about a line.TheLineEventclass encapsulates information that a line sends its listeners whenever the line opens, closes, starts, or stops.The LineEvent.Type inner class identifies what kind of event occurred on a line.Instances of classes that implement theLineListenerinterface can register to receive events when a line's status changes.ALineUnavailableExceptionis an exception indicating that a line cannot be opened because it is unavailable.A mixer is an audio device with one or more lines.TheMixer.Infoclass represents information about an audio mixer, including the product's name, version, and vendor, along with a textual description.Ports are simple lines for input or output of audio to or from audio devices.ThePort.Infoclass extendsLine.Infowith additional information specific to ports, including the port's name and whether it is a source or a target for its mixer.TheReverbTypeclass provides methods for accessing various reverberation settings to be applied to an audio signal.A source data line is a data line to which data may be written.A target data line is a type ofDataLinefrom which audio data can be read.AnUnsupportedAudioFileExceptionis an exception indicating that an operation failed because a file did not contain valid data of a recognized file type and format.