javax.sound.sampled

Интерфейсный Клип

Все Суперинтерфейсы:

AutoCloseable, DataLine, Строка

public interface Clip
extends DataLine

Clip интерфейс представляет специальный вид строки данных, аудиоданные которой могут быть загружены до воспроизведения, вместо того, чтобы быть переданными потоком в режиме реального времени.

Поскольку данные предварительно загружаются и имеют известную длину, можно установить клип, чтобы начать играть в любой позиции в ее аудиоданных. Можно также создать цикл, так, чтобы, когда клип играется, он неоднократно циклически повторялся. Циклы определяются с запуском и конечным демонстрационным фреймом, наряду с числом раз, что цикл должен играться.

Клипы могут быть получены из a Mixer это поддерживает строки этого типа. Данные загружаются в клип, когда они открываются.

Воспроизведение аудиоклипа может быть запущено и прекратило использовать start и stop методы. Эти методы не сбрасывают позицию носителей; start причины воспроизводят, чтобы продолжаться от позиции, где воспроизведение было последним, остановился. Чтобы перезапустить воспроизведение с начала аудиоданных клипа, просто следуйте за вызовом stop с setFramePosition (0), который перематывает носители к началу клипа.

С тех пор:

1.3

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от интерфейса javax.sound.sampled. DataLine

DataLine. Информация

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	LOOP_CONTINUOUSLY Значение, указывающее, что цикличное выполнение должно продолжаться неопределенно, а не полный после определенного числа циклов.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
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) Устанавливает позицию носителей в микросекундах.

Методы, наследованные от интерфейса javax.sound.sampled. DataLine

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

Методы, наследованные от интерфейса javax.sound.sampled. Строка

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

Полевая Деталь

LOOP_CONTINUOUSLY

static final int LOOP_CONTINUOUSLY

Значение, указывающее, что цикличное выполнение должно продолжаться неопределенно, а не полный после определенного числа циклов.

См. Также:

loop(int), Постоянные Значения полей

Деталь метода

открытый

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

Открывает клип, означая, что он должен получить любые необходимые системные ресурсы и стать операционным. Клип открывается с форматом и обозначенными аудиоданными. Если эта работа успешно выполняется, строка отмечается как открытая и OPEN событие диспетчеризируется слушателям строки.

Вызов этого метода на строке, которая уже открыта, недопустим и может привести к IllegalStateException.

Отметьте, что некоторые строки, когда-то закрытые, не могут быть вновь открыты. Попытки вновь открыть такую строку будут всегда приводить к a LineUnavailableException.

Параметры:

format - формат предоставленных аудиоданных

data - байтовый массив, содержащий аудиоданные, чтобы загрузиться в клип

offset - точка, в которой можно начать копировать, выраженный в байтах с начала массива

bufferSize - число байтов данных, чтобы загрузиться в клип от массива.

Броски:

LineUnavailableException - если строка не может быть открыта из-за ограничений ресурса

IllegalArgumentException - если размер буфера не представляет целое число демонстрационных фреймов, или если format не полностью определяется или не недопустим

IllegalStateException - если строка уже открыта

SecurityException - если строка не может быть открыта из-за ограничений безопасности

См. Также:

Line.close(), Line.isOpen(), LineListener

открытый

void open(AudioInputStream stream)
          throws LineUnavailableException,
                 IOException

Открывает клип с форматом и аудиоданными, существующими в обеспеченном потоке звукового входа. Открытие клипа означает, что должно получить любые необходимые системные ресурсы и стать операционным. Если этот входной поток работы. Если эта работа успешно выполняется, строка отмечается открытая и OPEN событие диспетчеризируется слушателям строки.

Вызов этого метода на строке, которая уже открыта, недопустим и может привести к IllegalStateException.

Отметьте, что некоторые строки, когда-то закрытые, не могут быть вновь открыты. Попытки вновь открыть такую строку будут всегда приводить к a LineUnavailableException.

Параметры:

stream - поток звукового входа, из которого аудиоданные будут считаны в клип

Броски:

LineUnavailableException - если строка не может быть открыта из-за ограничений ресурса

IOException - если исключение ввода-вывода происходит во время чтения потока

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)

Устанавливает позицию носителей в демонстрационных фреймах. Позиция основана на нуле; первый фрейм является нулем числа фрейма. Когда клип начнет играть в следующий раз, когда он запустится, играя фрейм в этой позиции.

Чтобы получить текущую позицию в демонстрационных фреймах, используйте getFramePosition метод DataLine.

Параметры:

frames - требуемая новая позиция носителей, выраженная в демонстрационных фреймах

setMicrosecondPosition

void setMicrosecondPosition(long microseconds)

Устанавливает позицию носителей в микросекундах. Когда клип начнет играть в следующий раз, когда он запустится в этой позиции. Уровень точности не гарантируется. Например, реализация могла бы вычислить позицию микросекунды от текущей позиции фрейма и частоты кадров аудиосэмпла. Точность в микросекундах была бы тогда ограничена числом микросекунд на демонстрационный фрейм.

Чтобы получить текущую позицию в микросекундах, используйте getMicrosecondPosition метод DataLine.

Параметры:

microseconds - требуемая новая позиция носителей, выраженная в микросекундах

setLoopPoints

void setLoopPoints(int start,
                 int end)

Устанавливает первые и последние демонстрационные фреймы, которые будут играться в цикле. Конечная точка должна быть больше чем или равной начальной точке, и оба должны находиться в пределах размера загруженных носителей. Значение 0 для начальной точки означает начало загруженных носителей. Точно так же значение-1 для конечной точки указывает на последний фрейм носителей.

Параметры:

start - стартовая позиция цикла, в демонстрационных (основанных на нуле) фреймах

end - конечная позиция цикла, в демонстрационных (основанных на нуле) фреймах, или-1, чтобы указать на заключительный фрейм

Броски:

IllegalArgumentException - если требуемые точки цикла не могут быть установлены, обычно потому что одно или оба падения вне продолжительности носителей или потому что конечная точка перед начальной точкой

цикл

void loop(int count)

Запускает воспроизведение цикличного выполнения с текущей позиции. Воспроизведение будет продолжаться к конечной точке цикла, тогда цикл назад к стартовой точке цикла count времена, и наконец продолжают воспроизведение до конца клипа.

Если текущая позиция, когда этот метод вызывается, больше чем конечная точка цикла, воспроизведение просто продолжается до конца клипа без цикличного выполнения.

A count значение 0 указывает, что любое текущее цикличное выполнение должно прекратиться, и воспроизведение должно продолжаться до конца клипа. Поведение неопределено, когда этот метод вызывается с любым другим значением во время работы цикла.

Если воспроизведение останавливается во время цикличного выполнения, текущее состояние цикла очищается; поведение последующего цикла и запускается, запросы не влияется прерванной работой цикла.

Параметры:

count - воспроизведение числа раз должно циклично выполниться назад от позиции конца цикла до позиции запуска цикла, или LOOP_CONTINUOUSLY указать, что цикличное выполнение должно продолжаться пока не прервано