javax.sound.sampled

Interface Line

All Superinterfaces:

AutoCloseable

All Known Subinterfaces:

Clip ， DataLine ， Mixer ， Port ， SourceDataLine ， TargetDataLine

public interface Line
extends AutoCloseable

所述Line接口表示单声道或多声道音频馈送。 线是数字音频“流水线”的一个元素，例如混频器，输入或输出端口，或进入或离开混频器的数据路径。

线可以有控制，如增益，平移和混响。 控件本身就是扩展基础Control类的类的实例。 Line接口提供两种访问方法来获取线路的控件： getControls返回整个集合，而getControl返回指定类型的单个控件。

线条在不同时期存在于各种状态。 当一条线路打开时，它将为其自身保留系统资源，当它关闭时，这些资源被释放用于其他对象或应用程序。 isOpen()方法可以让您发现线路是开放还是关闭。 然而，开线不需要处理数据。 这种处理通常由诸如SourceDataLine.write和TargetDataLine.read之类的SourceDataLine.write接口方法来TargetDataLine.read 。

每当线路状态发生变化时，您可以注册一个对象来接收通知。 该对象必须实现LineListener接口，它由单方法update 。 当线路打开和关闭时（如果是DataLine ，启动和停止），将调用此方法。

可以注册一个对象来监听多行。 它接收在其事件update方法将指定哪些线创建的事件，这是什么类型的事件（ OPEN ， CLOSE ， START ，或STOP ）许多样品如何帧的行，并在事件发生的时间已经处理。

某些行操作（如打开和关闭）可以在线路是共享音频资源时由非特权代码调用时生成安全异常。

从以下版本开始：

1.3

另请参见：

LineEvent

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Line.Info Line.Info对象包含有关行的信息。

方法摘要

Modifier and Type	Method and Description
void	addLineListener(LineListener listener) 在此行添加一个侦听器。
void	close() 关闭该行，表示可以释放该行所使用的任何系统资源。
Control	getControl(Control.Type control) 获取指定类型的控件，如果有的话。
Control[]	getControls() 获取与此行相关联的一组控件。
Line.Info	getLineInfo() 获取描述此行的 Line.Info对象。
boolean	isControlSupported(Control.Type control) 指示线路是否支持指定类型的控制。
boolean	isOpen() 表示线路是否打开，这意味着它已经预留了系统资源并且可以运行，尽管它可能当前没有播放或捕获声音。
void	open() 打开该行，表明它应该获取任何所需的系统资源并运行。
void	removeLineListener(LineListener listener) 从此行的侦听器列表中删除指定的侦听器。

方法详细信息

getLineInfo

Line.Info getLineInfo()

获取描述此行的 Line.Info对象。

结果

线的描述

open

void open()
   throws LineUnavailableException

打开该行，表明它应该获取任何所需的系统资源并运行。 如果此操作成功，该行将被标记为打开，并且OPEN事件将调度到该行的监听器。

请注意，一旦关闭，一些行不能重新打开。 尝试重新打开此行将始终导致LineUnavailableException 。

某些类型的行具有可能影响资源分配的可配置属性。 例如， DataLine必须以特定格式和缓冲区大小打开。 这样的行应该提供一种用于配置这些属性的机制，例如允许应用程序指定所需设置的open方法或方法。

此方法不使用参数，并打开与当前设置的行。 对于SourceDataLine和TargetDataLine对象，这意味着该行以默认设置打开。 但是，对于Clip ，在加载数据时确定缓冲区大小。 由于此方法不允许应用程序指定要加载的任何数据，因此将抛出IllegalArgumentException异常。 因此，你应该使用的一个open种提供的方法Clip接口将数据加载到Clip 。

对于DataLine ，如果用于检索该行的DataLine.Info对象指定了至少一个完全限定的音频格式，则最后一个将被用作默认格式。

异常

IllegalArgumentException - 如果在Clip实例上调用此方法。

LineUnavailableException - 如果由于资源限制，该行无法打开。

SecurityException - 如果由于安全限制，该行无法打开。

另请参见：

close() ， isOpen() ， LineEvent ， DataLine ， Clip.open(AudioFormat, byte[], int, int) ， Clip.open(AudioInputStream)

close

void close()

关闭该行，表示可以释放该行所使用的任何系统资源。 如果此操作成功，该行将被标记为关闭，并且CLOSE事件将发送到该行的监听器。

Specified by:

close在界面 AutoCloseable

异常

SecurityException - 如果线路由于安全限制而无法关闭。

另请参见：

open() ， isOpen() ， LineEvent

isOpen

boolean isOpen()

表示线路是否打开，这意味着它已经预留了系统资源并且可以运行，尽管它可能当前没有播放或捕获声音。

结果

true如果行是打开的，否则 false

另请参见：

open() ， close()

getControls

Control[] getControls()

获取与此行相关联的一组控件。 某些控件只有在线路打开时才可用。 如果没有控件，此方法返回一个长度为0的数组。

结果

控件的数组

另请参见：

getControl(javax.sound.sampled.Control.Type)

isControlSupported

boolean isControlSupported(Control.Type control)

指示线路是否支持指定类型的控制。 某些控件只有在线路打开时才可用。

参数

control - 查询支持的控件的类型

结果

true如果支持指定类型的至少一个控件，否则 false 。

getControl

Control getControl(Control.Type control)

获取指定类型的控件，如果有的话。 某些控件只有在线路打开时才可用。

参数

control - 请求的控件的类型

结果

指定类型的控制

异常

IllegalArgumentException - 如果不支持指定类型的控件

另请参见：

getControls() ， isControlSupported(Control.Type control)

addLineListener

void addLineListener(LineListener listener)

在此行添加一个侦听器。 每当行的状态发生变化时，监听器的update()方法将使用描述更改的LineEvent对象进行调用。

参数

listener - 作为监听器添加到此行的对象

另请参见：

removeLineListener(javax.sound.sampled.LineListener) ， LineListener.update(javax.sound.sampled.LineEvent) ， LineEvent

removeLineListener

void removeLineListener(LineListener listener)

从此行的侦听器列表中删除指定的侦听器。

参数

listener - 要删除的监听器

另请参见：

addLineListener(javax.sound.sampled.LineListener)