Интерфейс Clip
- Все суперинтерфейсы:
-
AutoCloseable,DataLine,Line
public interface Clip extends DataLine
Clip представляет собой специальный тип линейного аудиоданных, чьи данные можно загрузить перед воспроизведением, а не передавать в реальном времени. Поскольку данные загружаются заранее и имеют известную длину, вы можете указать, с какой позиции в аудиоданных начать воспроизведение клипа. Вы также можете создать цикл, чтобы клип повторялся при воспроизведении. Циклы определяются начальной и конечной позицией в кадрах с образцами, а также количеством повторов.
Клипы можно получить из Mixer, который поддерживает линии этого типа. Данные загружаются в клип при его открытии.
Воспроизведение аудиоклипа можно начать и остановить, используя методы start и stop. Эти методы не сбрасывают позицию медиа; start приводит к продолжению воспроизведения с позиции, на которой оно было остановлено в последний раз. Чтобы перезапустить воспроизведение с начала аудиоданных клипа, просто выполните вызов stop с setFramePosition(0), что перемотает медиа в начало клипа.
- С:
- 1.3
Краткое описание вложенных классов
Вложенные классы/интерфейсы, объявленные в интерфейсе javax.sound.sampled.DataLine
DataLine.Info
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
LOOP_CONTINUOUSLY |
Значение, указывающее, что циклическое воспроизведение должно продолжаться неопределенно, а не завершиться после определенного количества циклов. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
int |
getFrameLength() |
Получение длины медиа в кадрах с образцами. |
long |
getMicrosecondLength() |
Получение длительности медиа в микросекундах. |
void |
loop |
Запуск циклического воспроизведения с текущей позиции. |
void |
open |
Открывает клип, что означает, что он должен получить необходимые системные ресурсы и стать работоспособным. |
void |
open |
Открывает клип с форматом и аудиоданными, присутствующими в предоставленном потоке аудиовхода. |
void |
setFramePosition |
Устанавливает позицию медиа в кадрах с образцами. |
void |
setLoopPoints |
Устанавливает начальный и конечный кадры с образцами, которые будут воспроизводиться в цикле. |
void |
setMicrosecondPosition |
Устанавливает позицию медиа в микросекундах. |
Методы, объявленные в интерфейсе javax.sound.sampled.DataLine
available, drain, flush, getBufferSize, getFormat, getFramePosition, getLevel, getLongFramePosition, getMicrosecondPosition, isActive, isRunning, start, stop
Методы, объявленные в интерфейсе javax.sound.sampled.Line
addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener
Подробное описание полей
LOOP_CONTINUOUSLY
static final int LOOP_CONTINUOUSLY
- См. также:
Подробное описание методов
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- если линия не может быть открыта из-за ограничений безопасности - См. также:
open
void open(AudioInputStream stream) throws LineUnavailableException, IOException
OPEN. Вызов этого метода для линии, которая уже открыта, является недопустимым и может привести к IllegalStateException.
Обратите внимание, что некоторые линии после закрытия не могут быть повторно открыты. Попытка повторного открытия такой линии всегда приведет к LineUnavailableException.
- Параметры:
-
stream- поток аудиоввода, из которого аудиоданные будут считаны в клип - Исключения:
-
LineUnavailableException- если линия не может быть открыта из-за ограничений ресурсов -
IOException- если при чтении из потока возникает исключение I/O -
IllegalArgumentException- если аудиоформат потока не полностью указан или недействителен -
IllegalStateException- если линия уже открыта -
SecurityException- если линия не может быть открыта из-за ограничений безопасности - См. также:
getFrameLength
int getFrameLength()
- Возвращает:
- длительность медиа, выраженную в кадрах сэмплов, или
AudioSystem.NOT_SPECIFIEDесли линия не открыта - См. также:
getMicrosecondLength
long getMicrosecondLength()
- Возвращает:
- длительность медиа, выраженную в микросекундах, или
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)
- Параметры:
-
start- начальная позиция цикла в кадрах сэмплов (нулевая основа) -
end- конечная позиция цикла в кадрах сэмплов (нулевая основа) или -1 для указания последнего кадра - Исключения:
-
IllegalArgumentException- если запрошенные точки цикла не могут быть установлены, обычно потому, что одна или обе выходят за пределы длительности медиа или потому, что конечная точка находится перед начальной точкой
loop
void loop(int count)
count раз, и, наконец, продолжит воспроизведение до конца клипа. Если текущая позиция при вызове этого метода больше, чем конечная точка цикла, воспроизведение просто продолжается до конца клипа без циклического повторения.
Значение count равное 0 указывает на прекращение любого текущего циклического воспроизведения и продолжение воспроизведения до конца клипа. Поведение не определено, если этот метод вызывается с любым другим значением во время циклической операции.
Если воспроизведение остановлено во время циклического воспроизведения, текущий статус цикла очищается; поведение последующих запросов на циклическое воспроизведение и запуск не зависит от прерванной циклической операции.
- Параметры:
-
count- количество раз, когда воспроизведение должно циклически возвращаться от конечной точки цикла к начальной точке цикла, илиLOOP_CONTINUOUSLYдля указания, что циклическое воспроизведение должно продолжаться до прерывания
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/sound/sampled/Clip.html