javax.sound.sampled

Interface Clip

All Superinterfaces:

AutoCloseable， DataLine， Line

public interface Clip
extends DataLine

的 Clip接口代表一种特殊的数据线的音频数据可以被加载之前播放，而不是实时流。

由于数据是预先加载的，并且有一个已知的长度，你可以设置一个剪辑开始在它的音频数据中的任何位置开始播放。您还可以创建一个循环，以便在播放剪辑时，它将循环重复。循环中指定了一个开始和结束的示例框架，以及循环应该被播放的次数。

剪辑可以从支持这种类型的线Mixer获得。当打开数据时，数据被加载到一个剪辑中。

音频剪辑的播放可以启动和停止使用start和stop方法。这些方法不会重置的媒体定位；start原因回放继续从上次停止的位置在播放。重新播放的剪辑的音频数据的开始，只是遵循stop与setframeposition调用（0），它将媒体剪辑的开始。

从以下版本开始：

一点三

Nested Class Summary

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

DataLine.Info

Field Summary

Fields

Modifier and Type	Field and Description
static int	LOOP_CONTINUOUSLY 一个值表示循环应该继续下去而不是完成一个特定的圈数后。

方法摘要

Modifier and Type	Method and Description
int	getFrameLength() 在样本帧中获得媒体长度。
long	getMicrosecondLength() 获得媒体持续时间在微秒
void	loop(int count) 从当前位置开始循环播放。
void	open(AudioFormat format, byte[] data, int offset, int bufferSize) 打开剪辑，这意味着它应该获得任何所需的系统资源，并成为可操作的。
void	open(AudioInputStream stream) 打开所提供的音频输入流中的格式和音频数据的剪辑。
void	setFramePosition(int frames) 设置样本帧中的媒体位置。
void	setLoopPoints(int start, int end) 设置将在循环中播放的第一个和最后一个示例帧。
void	setMicrosecondPosition(long microseconds) 套在微秒的媒体位置。

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

Field Detail

LOOP_CONTINUOUSLY

static final int LOOP_CONTINUOUSLY

一个值表示循环应该继续下去而不是完成一个特定的圈数后。

另请参见：

loop(int)， Constant Field Values

方法详细信息

open

void open(AudioFormat format,
          byte[] data,
          int offset,
          int bufferSize)
   throws LineUnavailableException

打开剪辑，这意味着它应该获得任何所需的系统资源，并成为可操作的。该剪辑是打开与格式和音频数据表示。如果操作成功，该行标记为开放和 OPEN事件被派遣到线的听众。

调用该方法对线已经开是违法的，可能会导致一个IllegalStateException。

请注意，一些行，一旦关闭，不能重新打开。试图重开这一行总是导致LineUnavailableException。

参数

format -提供的音频数据格式

data -装入夹包含音频数据的字节数组

offset -点开始复制，表示字节从数组的开始

bufferSize -的数据的字节数装入夹从阵列。

异常

LineUnavailableException -如果线路不因资源限制打开

IllegalArgumentException如果缓冲区的大小并不代表样本帧的整数，或者 format不完全指定的或无效的

IllegalStateException如果线已经打开

SecurityException -如果线路不能由于安全限制打开

另请参见：

Line.close()， Line.isOpen()， LineListener

open

void open(AudioInputStream stream)
   throws LineUnavailableException,
          IOException

打开所提供的音频输入流中的格式和音频数据的剪辑。打开一个剪辑意味着它应该获得任何所需的系统资源，并成为可操作的。如果这个操作输入流。如果操作成功，该线的特点是开放和 OPEN事件被派遣到线的听众。

调用该方法对线已经开是违法的，可能会导致一个IllegalStateException。

请注意，一些行，一旦关闭，不能重新打开。试图重开这一行总是导致LineUnavailableException。

参数

stream -音频输入流从音频数据将被读入夹

异常

LineUnavailableException -如果线路不因资源限制打开

IOException如果流读书期间发生的I/O异常

IllegalArgumentException如果流的音频格式不完全指定的或无效的

IllegalStateException如果线已经打开

SecurityException -如果线路不能由于安全限制打开

另请参见：

Line.close()， Line.isOpen()， LineListener

getFrameLength

int getFrameLength()

在样本帧中获得媒体长度。

结果

媒体长度、样本框表示，或 AudioSystem.NOT_SPECIFIED如果线路不开。

另请参见：

AudioSystem.NOT_SPECIFIED

getMicrosecondLength

long getMicrosecondLength()

获得媒体持续时间在微秒

结果

媒体的持续时间，表示在微秒，或 AudioSystem.NOT_SPECIFIED如果线路不开。

另请参见：

AudioSystem.NOT_SPECIFIED

setFramePosition

void setFramePosition(int frames)

设置样本帧中的媒体位置。该位置为零，第一帧为帧号为零。当剪辑开始播放下一次，它将开始在这个位置上播放的框架。

获得样本框的当前位置，使用的方法DataLine getFramePosition。

参数

frames -所需的新媒体阵地，样本框表示

setMicrosecondPosition

void setMicrosecondPosition(long microseconds)

套在微秒的媒体位置。当剪辑开始播放下一次，它将开始在这个位置。精度水平没有保证。例如，一种可能的实现从当前帧的位置和音频采样帧率计算微秒的位置。在微秒的精度将被限制到微秒每样架数。

获得微秒的当前位置，使用的方法DataLine getMicrosecondPosition。

参数

microseconds -所需的新媒体阵地，用微秒

setLoopPoints

void setLoopPoints(int start,
                   int end)

设置将在循环中播放的第一个和最后一个示例帧。结束点必须大于或等于起始点，而且两个必须在加载的媒体的大小范围内下降。一个值为0的起始点意味着加载媒体的开始。同样，结束点的1的值表示媒体的最后一帧。

参数

start -循环的起始位置，在样品架（零基础）

end -循环的结束位置，在样品架（零基础），或1显示最后一帧

异常

如果要求 IllegalArgumentException环点不能设置，通常是因为一方或双方不在媒体的持续时间或因为终点前的起点

loop

void loop(int count)

从当前位置开始循环播放。回放不断循环的终点，然后回到循环的开始点 count倍，并继续播放到最后的剪辑。

如果当前位置调用此方法时大于循环结束点，播放简单地继续最后的剪辑没有循环。

一个0 count值表示当前循环停止和播放应该继续最后的剪辑。该方法在循环操作过程中调用任何其他值时，该方法是不定义的。

如果播放期间停止循环，电流环状态被清除；随后的回路和启动请求的行为是不间断循环操作的影响。

参数

count -次播放数环回从循环的结束位置到循环的起始位置，或 LOOP_CONTINUOUSLY表明循环继续直到中断