java.lang.Object
java.io.InputStream
javax.sound.sampled.AudioInputStream
- All Implemented Interfaces:
Closeable
,AutoCloseable
An audio input stream is an input stream with a specified audio format and
length. The length is expressed in sample frames, not bytes. Several methods
are provided for reading a certain number of bytes from the stream, or an
unspecified number of bytes. The audio input stream keeps track of the last
byte that was read. You can skip over an arbitrary number of bytes to get to
a later position for reading. An audio input stream may support marks. When
you set a mark, the current position is remembered so that you can return to
it later.
The AudioSystem
class includes many methods that manipulate
AudioInputStream
objects. For example, the methods let you:
- obtain an audio input stream from an external audio file, stream, or
URL
- write an external file from an audio input stream
- convert an audio input stream to a different audio format
- Since:
- 1.3
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionprotected AudioFormat
The format of the audio data contained in the stream.protected long
This stream's length, in sample frames.protected long
The current position in this stream, in sample frames (zero-based).protected int
The size of each frame, in bytes. -
Constructor Summary
ConstructorDescriptionAudioInputStream
(InputStream stream, AudioFormat format, long length) Constructs an audio input stream that has the requested format and length in sample frames, using audio data from the specified input stream.Constructs an audio input stream that reads its data from the target data line indicated. -
Method Summary
Modifier and TypeMethodDescriptionint
Returns the maximum number of bytes that can be read (or skipped over) from this audio input stream without blocking.void
close()
Closes this audio input stream and releases any system resources associated with the stream.Obtains the audio format of the sound data in this audio input stream.long
Obtains the length of the stream, expressed in sample frames rather than bytes.void
mark
(int readlimit) Marks the current position in this audio input stream.boolean
Tests whether this audio input stream supports themark
andreset
methods.int
read()
Reads the next byte of data from the audio input stream.int
read
(byte[] b) Reads some number of bytes from the audio input stream and stores them into the buffer arrayb
.int
read
(byte[] b, int off, int len) Reads up to a specified maximum number of bytes of data from the audio stream, putting them into the given byte array.void
reset()
Repositions this audio input stream to the position it had at the time itsmark
method was last invoked.long
skip
(long n) Skips over and discards a specified number of bytes from this audio input stream.Methods declared in class java.io.InputStream
nullInputStream, readAllBytes, readNBytes, readNBytes, skipNBytes, transferTo
-
Field Details
-
format
The format of the audio data contained in the stream. -
frameLength
protected long frameLengthThis stream's length, in sample frames. -
frameSize
protected int frameSizeThe size of each frame, in bytes. -
framePos
protected long framePosThe current position in this stream, in sample frames (zero-based).
-
-
Constructor Details
-
AudioInputStream
Constructs an audio input stream that has the requested format and length in sample frames, using audio data from the specified input stream.- Parameters:
stream
- the stream on which thisAudioInputStream
object is basedformat
- the format of this stream's audio datalength
- the length in sample frames of the data in this stream
-
AudioInputStream
Constructs an audio input stream that reads its data from the target data line indicated. The format of the stream is the same as that of the target data line, and the length isAudioSystem#NOT_SPECIFIED
.- Parameters:
line
- the target data line from which this stream obtains its data- See Also:
-
-
Method Details
-
getFormat
Obtains the audio format of the sound data in this audio input stream.- Returns:
- an audio format object describing this stream's format
-
getFrameLength
public long getFrameLength()Obtains the length of the stream, expressed in sample frames rather than bytes.- Returns:
- the length in sample frames
-
read
Reads the next byte of data from the audio input stream. The audio input stream's frame size must be one byte, or anIOException
will be thrown.- Specified by:
read
in classInputStream
- Returns:
- the next byte of data, or
-1
if the end of the stream is reached. - Throws:
IOException
- if an input or output error occurs- See Also:
-
read
Reads some number of bytes from the audio input stream and stores them into the buffer arrayb
. The number of bytes actually read is returned as an integer. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown.This method will always read an integral number of frames. If the length of the array is not an integral number of frames, a maximum of
b.length - (b.length % frameSize)
bytes will be read.- Overrides:
read
in classInputStream
- Parameters:
b
- the buffer into which the data is read.- Returns:
- the total number of bytes read into the buffer, or
-1
if there is no more data because the end of the stream has been reached. - Throws:
IOException
- if an input or output error occurs- See Also:
-
read
Reads up to a specified maximum number of bytes of data from the audio stream, putting them into the given byte array.This method will always read an integral number of frames. If
len
does not specify an integral number of frames, a maximum oflen - (len % frameSize)
bytes will be read.- Overrides:
read
in classInputStream
- Parameters:
b
- the buffer into which the data is read.off
- the start offset in arrayb
at which the data is written.len
- the maximum number of bytes to read.- Returns:
- the total number of bytes read into the buffer, or
-1
if there is no more data because the end of the stream has been reached. - Throws:
IOException
- if an input or output error occurs- See Also:
-
skip
Skips over and discards a specified number of bytes from this audio input stream.This method will always skip an integral number of frames. If
n
does not specify an integral number of frames, a maximum ofn - (n % frameSize)
bytes will be skipped.- Overrides:
skip
in classInputStream
- Parameters:
n
- the requested number of bytes to be skipped- Returns:
- the actual number of bytes skipped
- Throws:
IOException
- if an input or output error occurs- See Also:
-
available
Returns the maximum number of bytes that can be read (or skipped over) from this audio input stream without blocking. This limit applies only to the next invocation of aread
orskip
method for this audio input stream; the limit can vary each time these methods are invoked. Depending on the underlying stream, anIOException
may be thrown if this stream is closed.- Overrides:
available
in classInputStream
- Returns:
- the number of bytes that can be read from this audio input stream without blocking
- Throws:
IOException
- if an input or output error occurs- See Also:
-
close
Closes this audio input stream and releases any system resources associated with the stream.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Overrides:
close
in classInputStream
- Throws:
IOException
- if an input or output error occurs
-
mark
public void mark(int readlimit) Marks the current position in this audio input stream.- Overrides:
mark
in classInputStream
- Parameters:
readlimit
- the maximum number of bytes that can be read before the mark position becomes invalid- See Also:
-
reset
Repositions this audio input stream to the position it had at the time itsmark
method was last invoked.- Overrides:
reset
in classInputStream
- Throws:
IOException
- if an input or output error occurs- See Also:
-
markSupported
public boolean markSupported()Tests whether this audio input stream supports themark
andreset
methods.- Overrides:
markSupported
in classInputStream
- Returns:
true
if this stream supports themark
andreset
methods;false
otherwise- See Also:
-