Интерфейс Clip

static final int LOOP_CONTINUOUSLY

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

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

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

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

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

void open(AudioInputStream stream) throws LineUnavailableException, IOException

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

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

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

int getFrameLength()

Получает длительность медиа в образцах кадров.

long getMicrosecondLength()

Получает продолжительность медиа в микросекундах.

void setFramePosition(int frames)

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

Для получения текущей позиции в образцах кадров используйте метод getFramePosition объекта DataLine.

void setMicrosecondPosition(long microseconds)

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

Для получения текущей позиции в микросекундах используйте метод getMicrosecondPosition объекта DataLine.

void setLoopPoints(int start, int end)

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

void loop(int count)

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

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

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

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