|
Préférences
Moteurs de recherche
|
||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
javax.sound.sampled
|
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface javax.sound.sampled.DataLine |
---|
DataLine.Info |
Method Summary | |
---|---|
void |
open(AudioFormat format)
Opens the line with the specified format, causing the line to acquire any required system resources and become operational. |
void |
open(AudioFormat format,
int bufferSize)
Opens the line with the specified format and requested buffer size, causing the line to acquire any required system resources and become operational. |
int |
read(byte[] b,
int off,
int len)
Reads audio data from the data line's input buffer. |
Methods inherited from interface javax.sound.sampled.DataLine |
---|
available, drain, flush, getBufferSize, getFormat, getFramePosition, getLevel, getLongFramePosition, getMicrosecondPosition, isActive, isRunning, start, stop |
Methods inherited from interface javax.sound.sampled.Line |
---|
addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener |
Method Detail |
---|
void open(AudioFormat format, int bufferSize) throws LineUnavailableException
The buffer size is specified in bytes, but must represent an integral
number of sample frames. Invoking this method with a requested buffer
size that does not meet this requirement may result in an
IllegalArgumentException. The actual buffer size for the open line may
differ from the requested buffer size. The value actually set may be
queried by subsequently calling DataLine.getBufferSize()
If this operation succeeds, the line is marked as open, and an
event is dispatched to the
line's listeners.
OPEN
Invoking this method on a line that is already open is illegal
and may result in an IllegalStateException
.
Some lines, once closed, cannot be reopened. Attempts
to reopen such a line will always result in a
LineUnavailableException
.
format
- the desired audio formatbufferSize
- the desired buffer size, in bytes.
LineUnavailableException
- if the line cannot be
opened due to resource restrictions
IllegalArgumentException
- if the buffer size does not represent
an integral number of sample frames,
or if format
is not fully specified or invalid
IllegalStateException
- if the line is already open
SecurityException
- if the line cannot be
opened due to security restrictionsopen(AudioFormat)
,
Line.open()
,
Line.close()
,
Line.isOpen()
,
LineEvent
void open(AudioFormat format) throws LineUnavailableException
The implementation chooses a buffer size, which is measured in bytes but
which encompasses an integral number of sample frames. The buffer size
that the system has chosen may be queried by subsequently calling DataLine.getBufferSize()
If this operation succeeds, the line is marked as open, and an
event is dispatched to the
line's listeners.
OPEN
Invoking this method on a line that is already open is illegal
and may result in an IllegalStateException
.
Some lines, once closed, cannot be reopened. Attempts
to reopen such a line will always result in a
LineUnavailableException
.
format
- the desired audio format
LineUnavailableException
- if the line cannot be
opened due to resource restrictions
IllegalArgumentException
- if format
is not fully specified or invalid
IllegalStateException
- if the line is already open
SecurityException
- if the line cannot be
opened due to security restrictionsopen(AudioFormat, int)
,
Line.open()
,
Line.close()
,
Line.isOpen()
,
LineEvent
int read(byte[] b, int off, int len)
The number of bytes that can be read without blocking can be ascertained
using the
method of the
available
DataLine
interface. (While it is guaranteed that
this number of bytes can be read without blocking, there is no guarantee
that attempts to read additional data will block.)
The number of bytes to be read must represent an integral number of
sample frames, such that:
[ bytes read ] % [frame size in bytes ] == 0
b
- a byte array that will contain the requested input data when
this method returnsoff
- the offset from the beginning of the array, in byteslen
- the requested number of bytes to read
IllegalArgumentException
- if the requested number of bytes does
not represent an integral number of sample frames.
or if len
is negative.
ArrayIndexOutOfBoundsException
- if off
is negative,
or off+len
is greater than the length of the array
b
.SourceDataLine.write(byte[], int, int)
,
DataLine.available()