Интерфейс TargetDataLine

Все суперинтерфейсы:: AutoCloseable, DataLine, Line

public interface TargetDataLine extends DataLine

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

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

Линия целевого потока данных может быть получена из микшера, вызвав метод getLine интерфейса Mixer с соответствующим объектом DataLine.Info.

Интерфейс TargetDataLine предоставляет метод для чтения захваченных данных из буфера линии целевого потока данных. Приложения, которые записывают аудио, должны читать данные с линии целевого потока данных достаточно быстро, чтобы буфер не переполнялся, что может привести к разрывам в захваченных данных, воспринимаемым как щелчки. Приложения могут использовать метод available, определённый в интерфейсе DataLine, чтобы определить количество данных, в настоящее время находящихся в очереди в буфере линии данных. Если буфер переполнится, самые старые данные в очереди будут удалены и заменены новыми данными.

С:

1.3

См. также:

Краткое описание вложенных классов

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

DataLine.Info

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`open(AudioFormat format)`	Открывает линию с указанным форматом, заставляя линию получить все необходимые системные ресурсы и стать рабочей.
`void`	`open(AudioFormat format, int bufferSize)`	Открывает линию с указанным форматом и запрошенным размером буфера, заставляя линию получить все необходимые системные ресурсы и стать рабочей.
`int`	`read(byte[] b, int off, int len)`	Читает аудиоданные из буфера ввода линии данных.

Методы, объявленные в интерфейсе 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

Подробное описание методов

open

void open(AudioFormat format, int bufferSize) throws LineUnavailableException

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

Размер буфера указан в байтах, но должен представлять собой целое число образцов кадров. Вызов этого метода с запрошенным размером буфера, не соответствующим этому требованию, может привести к IllegalArgumentException. Фактический размер буфера для открытой линии может отличаться от запрошенного размера буфера. Фактическое установленное значение можно запросить, вызвав DataLine.getBufferSize()

Если эта операция выполняется успешно, линия помечается как открытая, и событие OPEN рассылается слушателям линии.

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

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

Параметры:

format - желаемый формат аудио

bufferSize - желаемый размер буфера в байтах

Исключения:

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

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

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

См. также:

open

void open(AudioFormat format) throws LineUnavailableException

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

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

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

Параметры:

format - желаемый формат аудио

Исключения:

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

IllegalArgumentException - если format не полностью указан или недействителен

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

См. также:

read

int read(byte[] b, int off, int len)

Читает аудиоданные из буфера ввода линии данных. Запрашиваемое количество байтов читается в указанный массив, начиная с указанного смещения в массиве в байтах. Этот метод блокируется до тех пор, пока не будет прочитано запрошенное количество данных. Однако, если линия данных закрыта, остановлена, опустошена или очищена, прежде чем будет прочитано запрошенное количество, метод больше не блокируется, а возвращает количество прочитанных до сих пор байтов.

Количество байтов, которые можно прочитать без блокировки, можно определить, используя метод available интерфейса DataLine. (Хотя гарантируется, что это количество байтов можно прочитать без блокировки, нет никакой гарантии, что попытки чтения дополнительных данных будут блокироваться.)

Количество байтов для чтения должно представлять собой целое число образцов кадров, такое что:

[ bytes read ] % [frame size in bytes ] == 0

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

Параметры:

b - массив байтов, который будет содержать запрошенные входные данные, когда этот метод возвращает

off - смещение от начала массива в байтах

len - запрошенное количество байтов для чтения

Возвращает:

количество фактически прочитанных байтов

Исключения:

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

ArrayIndexOutOfBoundsException - если off отрицательное, или off+len больше длины массива b

См. также:

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/sampled/TargetDataLine.html