SourceDataLine (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.sound.sampled
接口 SourceDataLine
public interface SourceDataLine
- extends DataLine
源数据行是可以写入数据的数据行。它充当其混频器的源。应用程序将音频字节写入源数据行，这样可处理字节缓冲并将它们传递给混频器。混频器可以将这些样本与取自其他源的样本混合起来，然后将该混合物传递到输出端口之类的目标（它可表示声卡上的音频输出设备）。
注意，此接口的命名约定反映了数据行及其混频器之间的关系。从应用程序的角度来看，源数据行可能充当音频数据的目标。
可以通过使用适当 DataLine.InfoMixer 的 getLine
SourceDataLine 接口提供将音频数据写入数据行的缓冲区中的方法。播放或混合音频的应用程序应该以足够快的速度将数据写入源数据行，以防缓冲区下溢（排空），下溢可能导致单击时音频数据中出现可感知的间断。应用程序可以使用在 DataLine 接口中定义的 availableSTOPSTART
- 从以下版本开始：
- 1.3
- 另请参见：
Mixer,DataLine,TargetDataLine
| 嵌套类摘要 |
|---|
| 从接口 javax.sound.sampled.DataLine 继承的嵌套类/接口 |
|---|
DataLine.Info |
| 方法摘要 | |
|---|---|
void |
open(AudioFormat format)
打开具有指定格式的行，这样可使行获得所有所需的系统资源并变得可操作。 |
void |
open(AudioFormat format,
int bufferSize)
打开具有指定格式和建议缓冲区大小的行，这样可使该行获得所有所需系统资源并变得可操作。 |
int |
write(byte[] b,
int off,
int len)
通过此源数据行将音频数据写入混频器。 |
| 从接口 javax.sound.sampled.DataLine 继承的方法 |
|---|
available, drain, flush, getBufferSize, getFormat, getFramePosition, getLevel, getLongFramePosition, getMicrosecondPosition, isActive, isRunning, start, stop |
| 从接口 javax.sound.sampled.Line 继承的方法 |
|---|
addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener |
| 方法详细信息 |
|---|
open
void open(AudioFormat format, int bufferSize) throws LineUnavailableException
- 打开具有指定格式和建议缓冲区大小的行，这样可使该行获得所有所需系统资源并变得可操作。
以字节为单位指定缓冲区大小，但该大小必须表示整数形式的样本帧数。使用不满足此要求的所请求缓冲区大小调用此方法可能导致 IllegalArgumentException。已打开的行的实际缓冲区大小可能与所请求缓冲区大小不同。实际设置的值可以通过后续调用
DataLine.getBufferSize()如果此操作成功，则将该行标记为 open，并向行的侦听器指派一个
OPEN在已经打开的行上调用此方法是非法的，并且可能导致
IllegalStateException。注意，有些行一旦关闭就无法重新打开。试图重新打开这样的行总是导致
LineUnavailableException。- 参数：
format- 所需的音频格式bufferSize- 所需的缓冲区大小- 抛出：
LineUnavailableException- 如果由于资源限制而无法打开行IllegalArgumentException- 如果缓冲区大小不表示整数形式的样本帧数，或者format未完全指定或是无效的IllegalStateException- 如果行已经打开SecurityException- 如果由于安全限制而无法打开行- 另请参见：
open(AudioFormat),Line.open(),Line.close(),Line.isOpen(),LineEvent
open
void open(AudioFormat format) throws LineUnavailableException
- 打开具有指定格式的行，这样可使行获得所有所需的系统资源并变得可操作。
该实现选择缓冲区大小，此大小是以字节为单位来测量的，但它不包括整数形式的样本帧数。系统选择的缓冲区大小可以通过后续调用
DataLine.getBufferSize()如果此操作成功，则将该行标记为 open，并向行的侦听器指派一个
OPEN在已经打开的行上调用此方法是非法的，并且可能导致
IllegalStateException。注意，有些行一旦关闭就无法重新打开。试图重新打开这样的行总是导致
LineUnavailableException。- 参数：
format- 所需音频格式- 抛出：
LineUnavailableException- 如果由于资源限制而无法打开行IllegalArgumentException- 如果format未完全指定的或是无效的IllegalStateException- 如果行已经打开SecurityException- 如果由于安全限制而无法打开行- 另请参见：
open(AudioFormat, int),Line.open(),Line.close(),Line.isOpen(),LineEvent
write
int write(byte[] b,
int off,
int len)
- 通过此源数据行将音频数据写入混频器。所请求的数据字节数是从指定的数组中读取的（从数组中给定的偏移量开始），并且将被写入数据行的缓冲区。如果调用者试图写入多于当前可写入数据量的数据（参见
available可以使用
DataLine接口的available要写入的字节数必须表示整数形式的样本帧数，比如：
[ bytes written ] % [frame size in bytes ] == 0
返回值将始终满足此要求。写入表示非整数形式的样本帧数的字节数的请求无法完成，并且可能导致IllegalArgumentException。- 参数：
b- 包含要写入数据行的数据的字节数组len- 数组中的有效数据的长度，以字节为单位（即要写入的请求数据量，以字节为单位）off- 数组开始处的偏移量，以字节为单位- 返回：
- 实际写入的字节数
- 抛出：
IllegalArgumentException- 如果所请求字节数不表示整数形式的样本帧数，或者len为负ArrayIndexOutOfBoundsException- 如果off为负，或者off+len大于数组b的长度。- 另请参见：
TargetDataLine.read(byte[], int, int),DataLine.available()
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。