Интерфейс 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.