Line (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.sound.sampled
接口 Line
- 所有已知子接口：
- Clip, DataLine, Mixer, Port, SourceDataLine, TargetDataLine
public interface Line
Line 接口表示单声道或多声道音频供给。line 是数字音频“管线”（如混频器、输入或输出端口，或往返于混频器的数据路径）的元素。
line 可以有各种控件，如 gain、pan 和 reverb。这些控件本身是扩展基本 ControlLine 接口提供两个获得 line 控件的访问器方法：getControlsgetControl
行在不同的时间以各种状态存在。当行打开时，它保留本身的系统资源；关闭时，这些资源就会为其他对象或应用程序释放。isOpen()SourceDataLine.writeTargetDataLine.read
可以注册一个对象，以便每当行状态更改时接收通知。该对象必须实现 LineListenerupdateDataLine）。
可以注册一个对象来侦听多个行。用其 update 方法接收的事件将指定创建该事件的行、事件的类型（OPEN、CLOSE、START 或 STOP），以及发生事件时该行处理的样本帧的数量。
如果行是共享的音频资源时由未授权的代码调用，则某些行操作（如 open 和 close）可以生成安全性异常。
- 从以下版本开始：
- 1.3
- 另请参见：
LineEvent
| 嵌套类摘要 | |
|---|---|
static class |
Line.Info
Line.Info 对象包含关于行的信息。 |
| 方法摘要 | |
|---|---|
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，且向行的侦听器指派一个
OPEN事件。注意，有些行一旦关闭就无法重新打开。试图重新打开这样的行总是导致
LineUnavailableException。某些类型的行具有可能影响资源分配的可配置属性。例如，必须使用特定格式和缓冲区大小打开
DataLine。此类行应该提供配置这些属性的机制，如允许应用程序指定所需设置的其他一个或多个open方法。此方法不使用任何参数，并使用当前设置打开行。对于
SourceDataLineTargetDataLineClipClip接口中提供的某一open方法将数据加载到Clip中。对于
DataLine，如果用于检索行的DataLine.Info对象至少指定一个完全限定的音频格式，则将使用最后一个格式作为默认格式。- 抛出：
IllegalArgumentException- 如果在 Clip 接口上调用此方法。LineUnavailableException- 如果由于资源限制无法打开该行。SecurityException- 如果由于安全限制无法打开该行。- 另请参见：
close(),isOpen(),LineEvent,DataLine,Clip.open(AudioFormat, byte[], int, int),Clip.open(AudioInputStream)
close
void close()
- 关闭行，指示可以释放的该行使用的所有系统资源。如果此操作成功，则将行标记为 closed，并给行的侦听器指派一个
CLOSE事件。- 抛出：
SecurityException- 如果由于安全限制无法关闭该行。- 另请参见：
open(),isOpen(),LineEvent
isOpen
boolean isOpen()
- 指示行是否已打开，行已打开则意味着它已保留系统资源并是可操作的，尽管它当前可能没有播放或捕获声音。
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)
- 将侦听器添加到此行。每当行的状态发生更改，就要使用描述更改的
LineEvent对象调用侦听器的update()方法。- 参数：
listener- 将作为侦听器添加到此行的对象- 另请参见：
removeLineListener(javax.sound.sampled.LineListener),LineListener.update(javax.sound.sampled.LineEvent),LineEvent
removeLineListener
void removeLineListener(LineListener listener)
- 从此行的侦听器列表中移除指定侦听器。
- 参数：
listener- 要移除的侦听器- 另请参见：
addLineListener(javax.sound.sampled.LineListener)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。