javax.sound.sampled

Интерфейс SourceDataLine

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

AutoCloseable, DataLine, Строка

public interface SourceDataLine
extends DataLine

Строка исходных данных является строкой данных, которой могут быть записаны данные. Это действует как источник к его микшеру. Приложение пишет аудио байты в строку исходных данных, которая обрабатывает буферизацию байтов и поставляет им микшеру. Микшер может смешать выборки с теми из других источников и затем поставить соединение цели, такой как выходной порт (который может представить устройство аудиовыхода на звуковой карте).

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

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

SourceDataLine интерфейс обеспечивает метод для того, чтобы он записал аудиоданные в буфер строки данных. Приложения, которые играют или смешивают аудио, должны записать данные в строку исходных данных достаточно быстро, чтобы препятствовать буферу терять значимость (освобождение), которое могло вызвать разрывы в аудио, которые воспринимаются как щелчки. Приложения могут использовать available метод, определенный в DataLine интерфейс, чтобы определить объем данных, в настоящий момент поставленный в очередь в буфере строки данных. Объем данных, который может быть записан буферу без блокирования, является различием между размером буфера и количеством данных с очередями. Если поставка аудиовыхода останавливается должный потерять значимость, a STOP событие сгенерировано. A START событие сгенерировано, когда аудиовыход возобновляется.

С тех пор:

1.3

См. Также:

Mixer, DataLine, TargetDataLine

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

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

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

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

Модификатор и Тип	Метод и Описание
void	open(AudioFormat format) Открывает строку с указанным форматом, заставляя строку получить любые необходимые системные ресурсы и стать операционным.
void	open(AudioFormat format, int bufferSize) Открывает строку с указанным форматом и предложенным размером буфера, заставляя строку получить любые необходимые системные ресурсы и стать операционным.
int	write(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 write(byte[] b,
          int off,
          int len)

Аудиоданные записей к микшеру через эту строку исходных данных. Требуемое число байтов данных читается из указанного массива, запускающегося при данном смещении в массив, и пишется буферу строки данных. Если вызывающая сторона пытается записать больше данных, чем можно в настоящий момент записать (см. available), этот метод блоки до требуемого объема данных был записан. Это применяется, даже если требуемый объем данных, чтобы записать больше чем размер буфера строки данных. Однако, если строка данных закрывается, остановилась, или сбросила прежде, чем требуемое количество было записано, метод больше не блокирует, но возвращает число байтов, записанных к настоящему времени.

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

Число байтов, чтобы записать должно представить целое число демонстрационных фреймов, так, что:

[ bytes written ] % [frame size in bytes ] == 0
Возвращаемое значение будет всегда удовлетворять это требование. Запрос, чтобы записать многие байты, представляющие нецелое число демонстрационных фреймов, не может быть выполнен и может привести к IllegalArgumentException.

Параметры:

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

len - длина, в байтах, допустимых данных в массиве (другими словами, требуемый объем данных, чтобы записать, в байтах)

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

Возвраты:

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

Броски:

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

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

См. Также:

TargetDataLine.read(byte[], int, int), DataLine.available()