方法详细信息

• drain

  void drain()

  通过继续数据I / O排出来自该行的数据，直到数据行的内部缓冲区被清空为止。 此方法将阻塞，直到排水完成。 因为这是一种阻止方法，所以应谨慎使用。 如果在其队列中包含数据的已停止行上调用drain() ，则该方法将阻塞，直到该行正在运行且数据队列变空。 如果一个线程调用drain() ，而另一个线程继续填充数据队列，则操作将无法完成。 数据线关闭时，此方法始终返回。

  另请参见：

  flush()

• flush

  void flush()

  刷新行中的排队数据。 刷新的数据被丢弃。 在某些情况下，并非所有排队的数据都可以被丢弃。 例如，混音器可以从缓冲区刷新特定输入行的数据，但仍然会播放输出缓冲区中已有的未播放数据（混合的结果）。 如果要在重新开始播放或捕获时跳过“陈旧”数据，可以在暂停一行（正常情况）后调用此方法。 （冲洗未停止的线路是合法的，但在活动线路上执行此操作可能会导致数据不连续，从而导致可察觉的点击。）

  另请参见：

  stop() ， drain()

• start

  void start()

  允许一行参与数据I / O. 如果在已经运行的行上调用，则此方法不执行任何操作。 除非已刷新缓冲区中的数据，否则该行将从该行停止时未处理的第一帧开始重新开始I / O. 音频捕获或回放开始时，会生成START事件。

  另请参见：

  stop() ， isRunning() ， LineEvent

• stop

  void stop()

  停止生产线。 停止的行应该停止I / O活动。 但是，如果该行已打开并正在运行，则应保留恢复活动所需的资源。 停止的行应该在其缓冲区中保留任何音频数据而不是丢弃它，以便在恢复时I / O可以在它停止的地方继续，如果可能的话。 （当然，这并不能保证当前缓冲区之外永远不会出现不连续性;如果停止条件持续时间过长，则可能会丢弃输入或输出样本。）如果需要，可以通过调用保留的数据来丢弃保留的数据。 flush方法。 当音频捕获或播放停止时，将生成STOP事件。

  另请参见：

  start() ， isRunning() ， flush() ， LineEvent

• isRunning

  boolean isRunning()

  指示线路是否正在运行。 默认值为false 。 当响应于start方法的调用而呈现第一数据时，开放行开始运行，并且继续直到呈现停止以响应对stop的调用或因为回放完成。

  结果

  true如果该行正在运行，否则为 false

  另请参见：

  start() ， stop()

• isActive

  boolean isActive()

  指示线路是否正在进行活动I / O（例如播放或捕获）。 当非活动行变为活动状态时，它会向其侦听器发送START事件。 同样，当活动行变为非活动状态时，它会发送STOP事件。

  结果

  true如果线路正在主动捕获或渲染声音，否则为 false

  另请参见：

  Line.isOpen() ， Line.addLineListener(javax.sound.sampled.LineListener) ， Line.removeLineListener(javax.sound.sampled.LineListener) ， LineEvent ， LineListener

• getFormat

  AudioFormat getFormat()

  获得数据线音频数据的当前格式（编码，采样率，通道数等）。

  如果该行未打开且从未打开过，则返回默认格式。 默认格式是特定于实现的音频格式，或者，如果用于检索此DataLine的DataLine.Info对象指定至少一个完全限定的音频格式，则最后一个将用作默认格式。 打开具有特定音频格式的行（例如SourceDataLine.open(AudioFormat) ）将覆盖默认格式。

  结果

  当前的音频数据格式

  另请参见：

  AudioFormat

• getBufferSize

  int getBufferSize()

  获得适合数据行内部缓冲区的最大数据字节数。 对于源数据行，这是可以写入数据的缓冲区的大小。 对于目标数据行，它是可以从中读取数据的缓冲区的大小。 请注意，使用的单位是字节，但始终对应于音频数据的整数个样本帧。

  结果

  缓冲区的大小，以字节为单位

• available

  int available()

  获取应用程序当前可用的数据字节数，以便在数据行的内部缓冲区中进行处理。 对于源数据行，这是可以在不阻塞的情况下写入缓冲区的数据量。 对于目标数据行，这是应用程序可读取的数据量。 对于剪辑，此值始终为0，因为在打开剪辑时音频数据会加载到缓冲区中，并且在剪辑关闭之前一直保持不变。

  请注意，使用的单位是字节，但始终对应于音频数据的整数个样本帧。

  应用程序保证最多available()返回的字节数的读或写操作不会阻塞; 但是，无法保证读取或写入更多数据的尝试将被阻止。

  结果

  可用数据量，以字节为单位

• getFramePosition

  int getFramePosition()

  以样本帧的形式获得音频数据中的当前位置。 帧位置测量自打开以来由线捕获或从线渲染的样本帧的数量。 此返回值将在2 ^ 31帧之后回绕。 建议改用getLongFramePosition 。

  结果

  自打开行以来已处理的帧数

  另请参见：

  getLongFramePosition()

• getLongFramePosition

  long getLongFramePosition()

  以样本帧的形式获得音频数据中的当前位置。 帧位置测量自打开以来由线捕获或从线渲染的样本帧的数量。

  结果

  自打开行以来已处理的帧数

  从以下版本开始：

  1.5

• getMicrosecondPosition

  long getMicrosecondPosition()

  获得音频数据中的当前位置，以微秒为单位。 微秒位置测量对应于自打开以来由线捕获或从线渲染的样本帧数的时间。 精度不保证。 例如，实现可以从当前帧位置和音频样本帧速率计算微秒位置。 然后，以微秒为单位的精度将限制为每个样本帧的微秒数。

  结果

  自打开行以来处理的数据的微秒数

• getLevel

  float getLevel()

  获得该行的当前音量级别。 此电平是信号电流幅度的度量，不应与增益控制的当前设置相混淆。 范围从0.0（静音）到1.0（声音波形的最大可能幅度）。 单位测量线性幅度，而不是分贝。

  结果

  此行中信号的当前幅度，或 AudioSystem.NOT_SPECIFIED