javax.sound.sampled

Interface DataLine

All Superinterfaces:

AutoCloseable ， Line

All Known Subinterfaces:

Clip ， SourceDataLine ， TargetDataLine

public interface DataLine
extends Line

DataLine将媒体相关功能添加到其超级接口， Line 。 此功能包括启动，停止，排除和刷新通过线路的音频数据的传输控制方法。 数据线还可以报告媒体的当前位置，音量和音频格式。 数据线用于通过允许应用程序写入数据的子SourceDataLine或Clip来输出音频。 类似地，音频输入由子TargetDataLine处理，这允许读取数据。

数据线具有内部缓冲器，其中输入或输出音频数据排队。 drain()方法阻塞，直到内部缓冲区变为空，通常是因为已处理所有排队的数据。 flush()方法从内部缓冲区中丢弃任何可用的排队数据。

每当数据线开始或停止数据的主动呈现或捕获时，数据线将生成START和STOP事件。 这些事件可以根据具体请求生成，也可以由于更少的直接状态更改而生成。 例如，如果在非活动数据线上调用start() ，并且数据可用于捕获或播放，则当数据播放或捕获实际开始时，将很快生成START事件。 或者，如果数据到活动数据线的流动被收缩，使得在数据呈现中发生间隙，则生成STOP事件。

混频器通常支持同步控制多条数据线。 可以通过Mixer界面的synchronize方法建立synchronize 。 请参阅Mixer Mixer描述，以获得更完整的描述。

从以下版本开始：

1.3

另请参见：

LineEvent

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	DataLine.Info 除了从其超类继承的类信息， DataLine.Info还提供了特定于数据行的附加信息。

方法摘要

Modifier and Type	Method and Description
int	available() 获取应用程序当前可用于数据线内部缓冲区中处理数据的字节数。
void	drain() 通过持续的数据I / O从排队排出数据，直到数据线的内部缓冲区被清空。
void	flush() 从行刷新排队的数据。
int	getBufferSize() 获取将适合数据线内部缓冲区的最大数据字节数。
AudioFormat	getFormat() 获取数据线音频数据的当前格式（编码，采样率，通道数等）。
int	getFramePosition() 获取音频数据中的样本帧中的当前位置。
float	getLevel() 获取该行的当前音量级别。
long	getLongFramePosition() 获取音频数据中的样本帧中的当前位置。
long	getMicrosecondPosition() 以微秒形式获取音频数据中的当前位置。
boolean	isActive() 指示线路是否处于活动I / O（例如播放或捕获）。
boolean	isRunning() 指示该行是否正在运行。
void	start() 允许线路从事数据I / O。
void	stop() 停止线。

Methods inherited from interface javax.sound.sampled.Line

addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener

方法详细信息

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第一数据时，开放行开始运行，并且继续直到呈现停止响应于对stop的调用或者因为播放完成。

结果

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

另请参见：

start() ， stop()

isActive

boolean isActive()

指示线路是否处于活动I / O（例如播放或捕获）。 当非活动行变为活动状态时，它会向其START发送一个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