-
- All Superinterfaces:
-
AutoCloseable
,DataLine
,Line
public interface TargetDataLine extends DataLine
目标数据线是可以读取音频数据的类型DataLine
。 最常见的示例是从音频捕获设备获取其数据的数据线。 (该设备实现为写入目标数据线的混音器。)请注意,此接口的命名约定反映了线路与其调音台之间的关系。 从应用的角度来看,目标数据线可以用作音频数据的源。
目标数据线可从混合器通过调用能够得到
getLine
的方法Mixer
与适当DataLine.Info
对象。TargetDataLine
接口提供了一种从目标数据线的缓冲区读取捕获的数据的方法。 记录音频的应用程序应该从目标数据行中快速读取数据,以防止缓冲区溢出,这可能导致被捕获的数据被视为点击的不连续性。 应用程序可以使用DataLine
接口中定义的available
方法来确定当前在数据行缓冲区中排队的数据量。 如果缓冲区溢出,则丢弃最旧的排队数据并替换为新数据。- 从以下版本开始:
- 1.3
- 另请参见:
-
Mixer
,DataLine
,SourceDataLine
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface javax.sound.sampled.DataLine
DataLine.Info
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 void
open(AudioFormat format)
以指定的格式打开行,使该行获取任何所需的系统资源,并可以运行。void
open(AudioFormat format, int bufferSize)
打开具有指定格式和请求的缓冲区大小的行,使该行获取任何所需的系统资源并变为可操作。int
read(byte[] b, int off, int len)
从数据线的输入缓冲区读取音频数据。-
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
-
-
-
-
方法详细信息
-
open
void open(AudioFormat format, int bufferSize) throws LineUnavailableException
打开具有指定格式和请求的缓冲区大小的行,使该行获取任何所需的系统资源并变为可操作。缓冲区大小以字节指定,但必须表示整数个采样帧。 以不满足此要求的请求缓冲区大小调用此方法可能会导致一个
IllegalArgumentException
。 开放行的实际缓冲区大小可能与请求的缓冲区大小不同。 实际设置的值可以随后调用DataLine.getBufferSize()
来查询如果此操作成功,该行将被标记为打开,并将
OPEN
事件调度到该行的侦听器。在已经打开的行上调用此方法是非法的,可能会导致一个
IllegalStateException
。一些封闭的线条无法重新开放。 重新打开此行的尝试将总是导致一个
LineUnavailableException
。- 参数
-
format
- 所需的音频格式 -
bufferSize
- 所需的缓冲区大小(以字节为单位) - 异常
-
LineUnavailableException
- 如果由于资源限制,该行无法打开 -
IllegalArgumentException
- 如果缓冲区大小不表示采样帧的整数,或者如果format
未完全指定或无效 -
IllegalStateException
- 如果该行已经打开 -
SecurityException
- 如果由于安全限制,该行无法打开 - 另请参见:
-
open(AudioFormat)
,Line.open()
,Line.close()
,Line.isOpen()
,LineEvent
-
open
void open(AudioFormat format) throws LineUnavailableException
以指定的格式打开行,使该行获取任何所需的系统资源,并可以运行。该实现选择一个缓冲区大小,以字节为单位测量,但包含整数个采样帧。 系统选择的缓冲区大小可以随后调用
DataLine.getBufferSize()
进行查询如果此操作成功,该行将被标记为打开,并将
OPEN
事件调度到该行的监听器。在已经打开的行上调用此方法是非法的,可能会导致一个
IllegalStateException
。一些封闭的线条无法重新开放。 尝试重新打开此行将始终导致一个
LineUnavailableException
。- 参数
-
format
- 所需的音频格式 - 异常
-
LineUnavailableException
- 如果由于资源限制,该行无法打开 -
IllegalArgumentException
- 如果format
未完全指定或无效 -
IllegalStateException
- 如果该行已经打开 -
SecurityException
- 如果由于安全限制,该行无法打开 - 另请参见:
-
open(AudioFormat, int)
,Line.open()
,Line.close()
,Line.isOpen()
,LineEvent
-
read
int read(byte[] b, int off, int len)
从数据线的输入缓冲区读取音频数据。 请求的字节数被读入指定的数组,从指定的偏移开始到数组中,以字节为单位。 该方法阻塞,直到所请求的数据量被读取为止。 但是,如果在读取请求的数据量之前关闭数据线,停止,排出或刷新,则该方法不再阻塞,但返回到目前为止读取的字节数。可以使用
DataLine
接口的available
方法确定可以读取而不阻塞的字节数。 (虽然保证这个字节数可以无阻塞地读取,但不能保证读取附加数据的尝试将被阻止。)要读取的字节数必须表示整数个采样帧,使得:
[ bytes read ] % [frame size in bytes ] == 0
返回值将始终满足此要求。 读取表示非整数样本帧的字节数的请求无法实现,并可能导致IllegalArgumentException异常。
- 参数
-
b
- 当该方法返回时将包含所请求的输入数据的字节数组 -
off
- 从数组开始的偏移量(以字节为单位) -
len
- 要读取的请求的字节数 - 结果
- 实际读取的字节数
- 异常
-
IllegalArgumentException
- 如果请求的字节数不表示采样帧的整数,或者如果len
为负数 -
ArrayIndexOutOfBoundsException
- 如果off
为负数,或off+len
大于数组长度b
- 另请参见:
-
SourceDataLine.write(byte[], int, int)
,DataLine.available()
-
-