Интерфейс Clip

public interface Clip
extends DataLine

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

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

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

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

Поля

LOOP_CONTINUOUSLY

static final int LOOP_CONTINUOUSLY

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

См. также:

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

Методы

open

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

Параметры:

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

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

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

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

Исключения:

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

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

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

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

См. также:

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

open

void open(AudioInputStream stream)
   throws LineUnavailableException,
          IOException

Параметры:

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)

Параметры:

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

setMicrosecondPosition

void setMicrosecondPosition(long microseconds)

Параметры:

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

setLoopPoints

void setLoopPoints(int start,
                   int end)

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

Параметры:

start - начальная позиция цикла в образцах (нумерация с нуля)

end - конечная позиция цикла в образцах (нумерация с нуля), или -1 для обозначения последнего кадра

Исключения:

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

loop

void loop(int count)

Параметры:

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