Writes a stream of bytes representing an audio file of the specified file type to the output stream provided. Some file types require that the length be written into the file header; such files cannot be written from start to finish unless the length is known in advance. An attempt to write a file of such a type will fail with an IOException if the length in the audio file type is AudioSystem.NOT_SPECIFIED.

stream	the audio input stream containing audio data to be written to the file
fileType	the kind of audio file to write
out	the stream to which the file data should be written
return	the number of bytes written to the output stream
Throws	IOException: if an input/output exception occurs
Throws	IllegalArgumentException: if the file type is not supported by the system
See also	isFileTypeSupported, getAudioFileTypes

Writes a stream of bytes representing an audio file of the specified file type to the external file provided.

stream	the audio input stream containing audio data to be written to the file
fileType	the kind of audio file to write
out	the external file to which the file data should be written
return	the number of bytes written to the file
Throws	IOException: if an I/O exception occurs
Throws	IllegalArgumentException: if the file type is not supported by the system
See also	isFileTypeSupported, getAudioFileTypes

Obtains the audio file format of the provided input stream. The stream must point to valid audio file data. The implementation of this method may require multiple parsers to examine the stream to determine whether they support it. These parsers must be able to mark the stream, read enough data to determine whether they support the stream, and, if not, reset the stream's read pointer to its original position. If the input stream does not support these operations, this method may fail with an IOException.

stream	the input stream from which file format information should be extracted
return	an AudioFileFormat object describing the stream's audio file format
Throws	UnsupportedAudioFileException: if the stream does not point to valid audio file data recognized by the system
Throws	IOException: if an input/output exception occurs
See also	markSupported, mark

Obtains the audio file format of the specified URL. The URL must point to valid audio file data.

url	the URL from which file format information should be extracted
return	an AudioFileFormat object describing the audio file format
Throws	UnsupportedAudioFileException: if the URL does not point to valid audio file data recognized by the system
Throws	IOException: if an input/output exception occurs

Obtains the audio file format of the specified File. The File must point to valid audio file data.

file	the File from which file format information should be extracted
return	an AudioFileFormat object describing the audio file format
Throws	UnsupportedAudioFileException: if the File does not point to valid audio file data recognized by the system
Throws	IOException: if an I/O exception occurs

Obtains the file types for which file writing support is provided by the system.

return

array of unique file types. If no file types are supported, an array of length 0 is returned.

Obtains the file types that the system can write from the audio input stream specified.

stream	the audio input stream for which audio file type support is queried
return	array of file types. If no file types are supported, an array of length 0 is returned.

Obtains an audio input stream of the indicated encoding, by converting the provided audio input stream.

targetEncoding	the desired encoding after conversion
sourceStream	the stream to be converted
return	an audio input stream of the indicated encoding
Throws	IllegalArgumentException: if the conversion is not supported
See also	getTargetEncodings(AudioFormat.Encoding), getTargetEncodings(AudioFormat), isConversionSupported(AudioFormat.Encoding, AudioFormat), getAudioInputStream(AudioFormat, AudioInputStream)

Obtains an audio input stream of the indicated format, by converting the provided audio input stream.

targetFormat	the desired audio format after conversion
sourceStream	the stream to be converted
return	an audio input stream of the indicated format
Throws	IllegalArgumentException: if the conversion is not supported #see #getTargetEncodings(AudioFormat)
See also	getTargetFormats(AudioFormat.Encoding, AudioFormat), isConversionSupported(AudioFormat, AudioFormat), getAudioInputStream(AudioFormat.Encoding, AudioInputStream)

Obtains an audio input stream from the provided input stream. The stream must point to valid audio file data. The implementation of this method may require multiple parsers to examine the stream to determine whether they support it. These parsers must be able to mark the stream, read enough data to determine whether they support the stream, and, if not, reset the stream's read pointer to its original position. If the input stream does not support these operation, this method may fail with an IOException.

stream	the input stream from which the AudioInputStream should be constructed
return	an AudioInputStream object based on the audio file data contained in the input stream.
Throws	UnsupportedAudioFileException: if the stream does not point to valid audio file data recognized by the system
Throws	IOException: if an I/O exception occurs
See also	markSupported, mark

Obtains an audio input stream from the URL provided. The URL must point to valid audio file data.

url	the URL for which the AudioInputStream should be constructed
return	an AudioInputStream object based on the audio file data pointed to by the URL
Throws	UnsupportedAudioFileException: if the URL does not point to valid audio file data recognized by the system
Throws	IOException: if an I/O exception occurs

Obtains an audio input stream from the provided File. The File must point to valid audio file data.

file	the File for which the AudioInputStream should be constructed
return	an AudioInputStream object based on the audio file data pointed to by the File
Throws	UnsupportedAudioFileException: if the File does not point to valid audio file data recognized by the system
Throws	IOException: if an I/O exception occurs

Obtains a clip that can be used for playing back an audio file or an audio stream. The returned clip will be provided by the default system mixer, or, if not possible, by any other mixer installed in the system that supports a Clip object.

The returned clip must be opened with the open(AudioFormat) or open(AudioInputStream) method.

This is a high-level method that uses getMixer and getLine internally.

If the system property javax.sound.sampled.Clip is defined or it is defined in the file "sound.properties", it is used to retrieve the default clip. For details, refer to the class description.

return	the desired clip object
Throws	LineUnavailableException: if a clip object is not available due to resource restrictions
Throws	SecurityException: if a clip object is not available due to security restrictions
Throws	IllegalArgumentException: if the system does not support at least one clip instance through any installed mixer
since	1.5
See also	getClip(Mixer.Info)

Obtains a clip from the specified mixer that can be used for playing back an audio file or an audio stream.

The returned clip must be opened with the open(AudioFormat) or open(AudioInputStream) method.

This is a high-level method that uses getMixer and getLine internally.

mixerInfo	a Mixer.Info object representing the desired mixer, or null for the system default mixer
return	a clip object from the specified mixer
Throws	LineUnavailableException: if a clip is not available from this mixer due to resource restrictions
Throws	SecurityException: if a clip is not available from this mixer due to security restrictions
Throws	IllegalArgumentException: if the system does not support at least one clip through the specified mixer
since	1.5
See also	getClip()

Indicates whether an audio input stream of the specified encoding can be obtained from an audio input stream that has the specified format.

targetEncoding	the desired encoding after conversion
sourceFormat	the audio format before conversion
return	true if the conversion is supported, otherwise false

Indicates whether an audio input stream of a specified format can be obtained from an audio input stream of another specified format.

targetFormat	the desired audio format after conversion
sourceFormat	the audio format before conversion
return	true if the conversion is supported, otherwise false

Indicates whether file writing support for the specified file type is provided by the system.

fileType	the file type for which write capabilities are queried
return	true if the file type is supported, otherwise false

Indicates whether an audio file of the specified file type can be written from the indicated audio input stream.

fileType	the file type for which write capabilities are queried
stream	the stream for which file-writing support is queried
return	true if the file type is supported for this audio input stream, otherwise false

Obtains a line that matches the description in the specified Line.Info object.

If a DataLine is requested, and info is an instance of DataLine.Info specifying at least one fully qualified audio format, the last one will be used as the default format of the returned DataLine.

If system properties javax.sound.sampled.Clip, javax.sound.sampled.Port, javax.sound.sampled.SourceDataLine and javax.sound.sampled.TargetDataLine are defined or they are defined in the file "sound.properties", they are used to retrieve default lines. For details, refer to the class description. If the respective property is not set, or the mixer requested in the property is not installed or does not provide the requested line, all installed mixers are queried for the requested line type. A Line will be returned from the first mixer providing the requested line type.

info	a Line.Info object describing the desired kind of line
return	a line of the requested kind
Throws	LineUnavailableException: if a matching line is not available due to resource restrictions
Throws	SecurityException: if a matching line is not available due to security restrictions
Throws	IllegalArgumentException: if the system does not support at least one line matching the specified Line.Info object through any installed mixer

Indicates whether the system supports any lines that match the specified Line.Info object. A line is supported if any installed mixer supports it.

info	a Line.Info object describing the line for which support is queried
return	true if at least one matching line is supported, otherwise false
See also	isLineSupported(Line.Info)

Obtains the requested audio mixer.

info	a Mixer.Info object representing the desired mixer, or null for the system default mixer
return	the requested mixer
Throws	SecurityException: if the requested mixer is unavailable because of security restrictions
Throws	IllegalArgumentException: if the info object does not represent a mixer installed on the system
See also	getMixerInfo

Obtains an array of mixer info objects that represents the set of audio mixers that are currently installed on the system.

return	an array of info objects for the currently installed mixers. If no mixers are available on the system, an array of length 0 is returned.
See also	getMixer

Obtains a source data line that can be used for playing back audio data in the format specified by the AudioFormat object. The returned line will be provided by the default system mixer, or, if not possible, by any other mixer installed in the system that supports a matching SourceDataLine object.

The returned line should be opened with the open(AudioFormat) or open(AudioFormat, int) method.

This is a high-level method that uses getMixer and getLine internally.

The returned SourceDataLine's default audio format will be initialized with format.

If the system property javax.sound.sampled.SourceDataLine is defined or it is defined in the file "sound.properties", it is used to retrieve the default source data line. For details, refer to the class description.

format	an AudioFormat object specifying the supported audio format of the returned line, or null for any audio format
return	the desired SourceDataLine object
Throws	LineUnavailableException: if a matching source data line is not available due to resource restrictions
Throws	SecurityException: if a matching source data line is not available due to security restrictions
Throws	IllegalArgumentException: if the system does not support at least one source data line supporting the specified audio format through any installed mixer
since	1.5
See also	getSourceDataLine(AudioFormat, Mixer.Info)

Obtains a source data line that can be used for playing back audio data in the format specified by the AudioFormat object, provided by the mixer specified by the Mixer.Info object.

The returned line should be opened with the open(AudioFormat) or open(AudioFormat, int) method.

This is a high-level method that uses getMixer and getLine internally.

The returned SourceDataLine's default audio format will be initialized with format.

format	an AudioFormat object specifying the supported audio format of the returned line, or null for any audio format
mixerinfo	a Mixer.Info object representing the desired mixer, or null for the system default mixer
return	the desired SourceDataLine object
Throws	LineUnavailableException: if a matching source data line is not available from the specified mixer due to resource restrictions
Throws	SecurityException: if a matching source data line is not available from the specified mixer due to security restrictions
Throws	IllegalArgumentException: if the specified mixer does not support at least one source data line supporting the specified audio format
since	1.5
See also	getSourceDataLine(AudioFormat)

Obtains information about all source lines of a particular type that are supported by the installed mixers.

info	a Line.Info object that specifies the kind of lines about which information is requested
return	an array of Line.Info objects describing source lines matching the type requested. If no matching source lines are supported, an array of length 0 is returned.
See also	getSourceLineInfo(Line.Info)

Obtains a target data line that can be used for recording audio data in the format specified by the AudioFormat object. The returned line will be provided by the default system mixer, or, if not possible, by any other mixer installed in the system that supports a matching TargetDataLine object.

The returned line should be opened with the open(AudioFormat) or open(AudioFormat, int) method.

This is a high-level method that uses getMixer and getLine internally.

The returned TargetDataLine's default audio format will be initialized with format.

format	an AudioFormat object specifying the supported audio format of the returned line, or null for any audio format
return	the desired TargetDataLine object
Throws	LineUnavailableException: if a matching target data line is not available due to resource restrictions
Throws	SecurityException: if a matching target data line is not available due to security restrictions
Throws	IllegalArgumentException: if the system does not support at least one target data line supporting the specified audio format through any installed mixer
since	1.5
See also	getTargetDataLine(AudioFormat, Mixer.Info), javax.sound.sampled.AudioPermission

Obtains a target data line that can be used for recording audio data in the format specified by the AudioFormat object, provided by the mixer specified by the Mixer.Info object.

The returned line should be opened with the open(AudioFormat) or open(AudioFormat, int) method.

This is a high-level method that uses getMixer and getLine internally.

The returned TargetDataLine's default audio format will be initialized with format.

If the system property javax.sound.sampled.TargetDataLine is defined or it is defined in the file "sound.properties", it is used to retrieve the default target data line. For details, refer to the class description.

format	an AudioFormat object specifying the supported audio format of the returned line, or null for any audio format
mixerinfo	a Mixer.Info object representing the desired mixer, or null for the system default mixer
return	the desired TargetDataLine object
Throws	LineUnavailableException: if a matching target data line is not available from the specified mixer due to resource restrictions
Throws	SecurityException: if a matching target data line is not available from the specified mixer due to security restrictions
Throws	IllegalArgumentException: if the specified mixer does not support at least one target data line supporting the specified audio format
since	1.5
See also	getTargetDataLine(AudioFormat), javax.sound.sampled.AudioPermission

Obtains the encodings that the system can obtain from an audio input stream with the specified encoding using the set of installed format converters.

sourceEncoding	the encoding for which conversion support is queried
return	array of encodings. If sourceEncodingis not supported, an array of length 0 is returned. Otherwise, the array will have a length of at least 1, representing sourceEncoding (no conversion).

Obtains the encodings that the system can obtain from an audio input stream with the specified format using the set of installed format converters.

sourceFormat	the audio format for which conversion is queried
return	array of encodings. If sourceFormatis not supported, an array of length 0 is returned. Otherwise, the array will have a length of at least 1, representing the encoding of sourceFormat (no conversion).

Obtains the formats that have a particular encoding and that the system can obtain from a stream of the specified format using the set of installed format converters.

targetEncoding	the desired encoding after conversion
sourceFormat	the audio format before conversion
return	array of formats. If no formats of the specified encoding are supported, an array of length 0 is returned.

Obtains information about all target lines of a particular type that are supported by the installed mixers.

info	a Line.Info object that specifies the kind of lines about which information is requested
return	an array of Line.Info objects describing target lines matching the type requested. If no matching target lines are supported, an array of length 0 is returned.
See also	getTargetLineInfo(Line.Info)