Module java.desktop
Package javax.sound.sampled

Interface TargetDataLine

所有超级接口:
AutoCloseable, DataLine, Line
public interface TargetDataLine extends DataLine
目标数据线是一种可以从中读取音频数据的DataLine类型。最常见的例子是从音频捕获设备获取数据的数据线。（该设备实现为写入目标数据线的混音器。）

请注意，此接口的命名约定反映了线路与其混音器之间的关系。从应用程序的角度来看，目标数据线可以作为音频数据的源。

可以通过使用适当的DataLine.Info对象调用Mixer的getLine方法从混音器获取目标数据线。

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

自1.3版本起:
1.3
参见:

  • Method Details

    • open

      void open(AudioFormat format, int bufferSize) throws LineUnavailableException
      使用指定的格式和请求的缓冲区大小打开线路，导致线路获取任何所需的系统资源并变为可操作状态。

      缓冲区大小以字节为单位指定，但必须表示为样本帧的整数倍。如果使用不符合此要求的请求缓冲区大小调用此方法可能会导致IllegalArgumentException。实际打开线路的缓冲区大小可能与请求的缓冲区大小不同。可以通过随后调用DataLine.getBufferSize()来查询实际设置的缓冲区大小。

      如果此操作成功，线路将标记为打开，并向线路的侦听器分派OPEN事件。

      在已经打开的线路上调用此方法是非法的，可能会导致IllegalStateException。

      一些线路一旦关闭就无法重新打开。尝试重新打开此类线路将始终导致LineUnavailableException。

      参数:
      format - 所需的音频格式
      bufferSize - 缓冲区的所需大小，以字节为单位
      抛出:
      LineUnavailableException - 如果由于资源限制而无法打开线路
      IllegalArgumentException - 如果缓冲区大小不表示样本帧的整数倍，或者format未完全指定或无效
      IllegalStateException - 如果线路已经打开
      SecurityException - 如果由于安全限制而无法打开线路
      参见:

    • open

      void open(AudioFormat format) throws LineUnavailableException
      使用指定的格式打开线路，导致线路获取任何所需的系统资源并变为可操作状态。

      实现会选择一个缓冲区大小，以字节为单位，但包含整数个样本帧。系统选择的缓冲区大小可以通过随后调用DataLine.getBufferSize()来查询。

      如果此操作成功，线路将标记为打开，并向线路的侦听器分派OPEN事件。

      在已经打开的线路上调用此方法是非法的，可能会导致IllegalStateException。

      一些线路一旦关闭就无法重新打开。尝试重新打开此类线路将始终导致LineUnavailableException。

      参数:
      format - 所需的音频格式
      抛出:
      LineUnavailableException - 如果由于资源限制而无法打开线路
      IllegalArgumentException - 如果format未完全指定或无效
      IllegalStateException - 如果线路已经打开
      SecurityException - 如果由于安全限制而无法打开线路
      参见:

    • read

      int read(byte[] b, int off, int len)
      从数据线的输入缓冲区读取音频数据。请求的字节数将被读入指定的数组中，从字节数组的指定偏移量开始。此方法将阻塞，直到已读取请求的数据量。但是，如果在读取请求的数据量之前数据线关闭、停止、排空或刷新，则该方法不再阻塞，而是返回到目前为止已读取的字节数。

      可以使用DataLine接口的available方法来确定可以无阻塞读取的字节数。（虽然保证可以无阻塞读取这些字节数，但不能保证尝试读取其他数据会阻塞。）

      要读取的字节数必须表示样本帧的整数倍，即：

      [读取的字节数] % [每帧的字节大小] == 0

      返回值将始终满足此要求。请求读取代表非整数样本帧数量的字节数的请求无法满足，可能导致IllegalArgumentException。

      参数:
      b - 当此方法返回时将包含请求的输入数据的字节数组
      off - 从数组开头的偏移量，以字节为单位
      len - 要读取的请求字节数
      返回:
      实际读取的字节数
      抛出:
      IllegalArgumentException - 如果请求的字节数不表示样本帧的整数倍，或者len为负
      ArrayIndexOutOfBoundsException - 如果off为负，或者off+len大于数组b的长度
      参见: