Интерфейс TargetDataLine

void open(AudioFormat format, int bufferSize) throws LineUnavailableException

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

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

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

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

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

void open(AudioFormat format) throws LineUnavailableException

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

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

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

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

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

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

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

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

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

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

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