javax.sound.sampled

Interface SourceDataLine

All Superinterfaces:

AutoCloseable， DataLine， Line

public interface SourceDataLine
extends DataLine

源数据线是一个数据可能被写入的数据线。它作为它的混频器的源。一个应用程序将音频字节写入一个源数据线，该行处理字节的缓冲，并将它们传送到混频器。该混频器可以将样品与其他来源的样品混合，然后将它们混合到目标，例如输出端口（可在声卡上表示音频输出设备）。

请注意，这个接口的命名约定反映了该行和它的混合机之间的关系。从应用程序的角度来看，源数据线可以作为音频数据的目标。

源数据线可以通过调用的方法Mixer getLine与适当的DataLine.Info对象从混频器得到。

的SourceDataLine接口提供了一种写作的音频数据到数据线的缓冲区。应用程序播放或混合音频应该写数据到足够快的源数据线保持缓冲区下溢（排空），这可能会导致被视为点击音频的不连续性。应用程序可以使用在DataLine接口定义的数据量，目前排队在数据线的缓冲区available方法。可以写入到缓冲区中的数据量，而不阻塞的缓冲区大小和队列数据的量之间的差异。如果音频输出的传递而停止下溢，产生一个STOP事件。一个START事件时产生的音频输出简历。

从以下版本开始：

一点三

另请参见：

Mixer， DataLine， TargetDataLine

Nested Class Summary

Nested classes/interfaces inherited from interface javax.sound.sampled.DataLine

DataLine.Info

方法摘要

Modifier and Type	Method and Description
void	open(AudioFormat format) 打开与指定的格式的行，导致该行获得任何所需的系统资源，并成为可操作的。
void	open(AudioFormat format, int bufferSize) 打开指定的格式和建议的缓冲区大小的行，导致该行获得任何所需的系统资源并成为可操作的。
int	write(byte[] b, int off, int len) 通过此源数据线将音频数据写入密炼机中。

Methods inherited from interface javax.sound.sampled.DataLine

available, drain, flush, getBufferSize, getFormat, getFramePosition, getLevel, getLongFramePosition, getMicrosecondPosition, isActive, isRunning, start, stop

Methods inherited from interface javax.sound.sampled.Line

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

方法详细信息

open

void open(AudioFormat format,
          int bufferSize)
   throws LineUnavailableException

打开指定的格式和建议的缓冲区大小的行，导致该行获得任何所需的系统资源并成为可操作的。

缓冲区大小是以字节为单位指定的，但必须表示样本帧的整数数目。调用该方法与请求的缓冲区大小，不符合这一要求可能导致时。打开的行的实际缓冲区大小可能与所请求的缓冲区大小不同。实际设定值可由DataLine.getBufferSize()随后打电话查询。

如果操作成功，该行标记为打开，和一个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事件被派遣到线的听众。

调用该方法对线已经开是违法的，可能会导致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()