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事件。

混频器经常支持多个数据线的同步控制。同步可以通过调音台界面的synchronize方法建立。看到一个更完整的描述的Mixer接口描述。

从以下版本开始：

一点三

另请参见：

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() 通过持续的数据输入输出排队的数据，直到数据线的内部缓冲区被清空为止。
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()

通过持续的数据输入输出排队的数据，直到数据线的内部缓冲区被清空为止。此方法块，直到耗尽完成。因为这是一个阻塞的方法，它应该使用的护理。如果 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.Info对象，以获取该DataLine，指定至少一个完全合格的音频格式，最后一个将被用作默认的格式。与一个特定的音频格式开放线（如SourceDataLine.open(AudioFormat)）将覆盖默认格式。

结果

当前音频数据格式

另请参见：

AudioFormat

getBufferSize

int getBufferSize()

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

结果

字节的缓冲区的大小

available

int available()

获取当前用于处理数据线内部缓冲区中的应用程序的数据的字节数。对于源数据线，这是可以写入缓冲区而不阻塞的数据量。对于目标数据线，这是应用程序读取的数据量。对于一个剪辑，这个值总是0，因为音频数据加载到缓冲区时，剪辑打开，并坚持不修改，直到剪辑关闭。

请注意，所使用的单位为字节，但将总是对应于音频数据的样本帧的整数数目。

一个应用程序是保证一个读或写到返回的字节数available()操作不会阻塞；然而，有没有保证，试图读取或写入更多的数据块。

结果

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

getFramePosition

int getFramePosition()

在音频数据中获得当前位置，在样本帧中。帧位置测量从打开的样本帧的数量或呈现的，该行的数量。这个返回值将在2个31个帧后结束。建议使用 getLongFramePosition相反。

结果

已处理的帧的数量，因为该行被打开

另请参见：

getLongFramePosition()

getLongFramePosition

long getLongFramePosition()

在音频数据中获得当前位置，在样本帧中。帧位置测量从打开的样本帧的数量或呈现的，该行的数量。

结果

已处理的帧的数量，因为该行被打开

从以下版本开始：

一点五

getMicrosecondPosition

long getMicrosecondPosition()

得到的音频数据的当前位置，在微秒。微秒位置测量相应的样本帧捕获的数的时间，或者使之从，行自打开。精度水平没有保证。例如，一种可能的实现从当前帧的位置和音频采样帧率计算微秒的位置。在微秒的精度将被限制到微秒每样架数。

结果

加工的自线建成数据的微秒数

getLevel

float getLevel()

获取行的当前音量级别。此电平是一个测量信号的电流幅度，不应该与当前的增益控制设置混淆。该范围是从0（静音）到1（最大可能的声音波形的振幅）。该装置测量线性幅度，没有分贝。

结果

在这条线的信号电流的幅值，或 AudioSystem.NOT_SPECIFIED