模块  java.desktop
软件包  javax.sound.sampled

Interface TargetDataLine

  • All Superinterfaces:
    AutoCloseableDataLineLine

    public interface TargetDataLineextends DataLine
    目标数据线是DataLine的类型,可以从中读取音频数据。 最常见的示例是从音频捕获设备获取其数据的数据线。 (该设备实现为写入目标数据线的混合器。)

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

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

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

    从以下版本开始:
    1.3
    另请参见:
    MixerDataLineSourceDataLine
    • 方法详细信息

      • 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
      • 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()