Интерфейс SourceDataLine

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 write(byte[] b, int off, int len)

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

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

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

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

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