All Superinterfaces:

AutoCloseable ， DataLine ， Line
```
public interface TargetDataLine
extends DataLine
```
目标数据线是DataLine的类型，可以从中读取音频数据。最常见的示例是从音频捕获设备获取其数据的数据线。（该设备实现为写入目标数据线的混合器。）
请注意，此接口的命名约定反映了该行与其混音器之间的关系。从应用程序的角度来看，目标数据线可以充当音频数据的源。

目标数据线可从混合器通过调用来获得getLine的方法Mixer用适当DataLine.Info对象。

TargetDataLine接口提供了一种从目标数据线缓冲区读取捕获数据的方法。记录音频的应用程序应该足够快地从目标数据线读取数据，以防止缓冲区溢出，这可能导致捕获的数据中的不连续性被视为点击。应用程序可以使用DataLine接口中定义的available方法来确定当前在数据行缓冲区中排队的数据量。如果缓冲区溢出，则丢弃最旧的排队数据并替换为新数据。

从以下版本开始：

1.3

另请参见：

Mixer ， DataLine ， SourceDataLine

嵌套类汇总
- Nested classes/interfaces declared in interface javax.sound.sampled.DataLine
  DataLine.Info

方法摘要

所有方法实例方法抽象方法
变量和类型	方法	描述
`void`	`open(AudioFormat format)`	打开具有指定格式的行，使该行获取任何所需的系统资源并开始运行。
`void`	`open(AudioFormat format, int bufferSize)`	打开具有指定格式和请求的缓冲区大小的行，使该行获取任何所需的系统资源并开始运行。
`int`	`read(byte[] b, int off, int len)`	从数据线的输入缓冲区读取音频数据。

声明方法的接口 javax.sound.sampled.DataLine
available, drain, flush, getBufferSize, getFormat, getFramePosition, getLevel, getLongFramePosition, getMicrosecondPosition, isActive, isRunning, start, stop

声明方法的接口 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()

Interface TargetDataLine

嵌套类汇总

Nested classes/interfaces declared in interface javax.sound.sampled.DataLine

方法摘要

声明方法的接口 javax.sound.sampled.DataLine

声明方法的接口 javax.sound.sampled.Line

方法详细信息

open

open

read