javax.sound.sampled

Интерфейс TargetDataLine

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

AutoCloseable, DataLine, Строка

public interface TargetDataLine
extends DataLine

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

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

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

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

С тех пор:

1.3

См. Также:

Mixer, DataLine, SourceDataLine

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

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

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

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

Модификатор и Тип	Метод и Описание
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. Строка

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

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

открытый

void open(AudioFormat format,
          int bufferSize)
   throws LineUnavailableException

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

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

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

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

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

Параметры:

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

bufferSize - требуемый размер буфера, в байтах.

Броски:

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

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

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

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

См. Также:

open(AudioFormat), Line.open(), Line.close(), Line.isOpen(), LineEvent

открытый

void open(AudioFormat format)
   throws LineUnavailableException

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

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

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

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

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

Параметры:

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

Броски:

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

IllegalArgumentException - если format не полностью определяется или не недопустим

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

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

См. Также:

open(AudioFormat, int), Line.open(), Line.close(), Line.isOpen(), LineEvent

читать

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.

См. Также:

SourceDataLine.write(byte[], int, int), DataLine.available()