Интерфейс Line

public interface Line
extends AutoCloseable

Интерфейс Line представляет собой моно- или многоканальный аудиопоток. Линия — это элемент цифровой аудио«трубы», например, микшер, входной или выходной порт или тракт данных в микшер или из него.

Линия может иметь управления, такие как громкость, панорамирование и реверберацию. Сами управления являются экземплярами классов, которые расширяют базовый класс Control. Интерфейс Line предоставляет два метода доступа для получения управлений линии: getControls возвращает весь набор, а getControl возвращает одно управление указанного типа.

Линии существуют в различных состояниях в разное время. При открытии линии она резервирует системные ресурсы для себя, а при закрытии эти ресурсы освобождаются для других объектов или приложений. Метод isOpen() позволяет определить, открыта или закрыта линия. Однако открытая линия не обязательно обрабатывает данные. Такая обработка обычно инициируется методами подинтерфейсов, такими как SourceDataLine.write и TargetDataLine.read.

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

Объект может быть зарегистрирован для прослушивания нескольких линий. Событие, которое он получит в методе update, укажет, какая линия создала событие, какой тип события это было (OPEN, CLOSE, START, или STOP), и сколько образцов кадров обработала линия в момент возникновения события.

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

Методы

getLineInfo

Line.Info getLineInfo()

Получает объект Line.Info, описывающий эту линию.

Возвращает:

описание линии

open

void open()
   throws LineUnavailableException

Исключения:

IllegalArgumentException - если этот метод вызывается на экземпляре Clip.

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

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

См. также:

close(), isOpen(), LineEvent, DataLine, Clip.open(AudioFormat, byte[], int, int), Clip.open(AudioInputStream)

close

void close()

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

Определено в:

close в интерфейсе AutoCloseable

Исключения:

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

См. также:

open(), isOpen(), LineEvent

isOpen

boolean isOpen()

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

Возвращает:

true если линия открыта, в противном случае false

См. также:

open(), close()

getControls

Control[] getControls()

Получает набор управлений, связанных с этой линией. Некоторые управления могут быть доступны только когда линия открыта. Если управлений нет, этот метод возвращает массив длиной 0.

Возвращает:

массив управлений

См. также:

getControl(javax.sound.sampled.Control.Type)

isControlSupported

boolean isControlSupported(Control.Type control)

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

Параметры:

control - тип управления, для которого запрашивается поддержка

Возвращает:

true если по крайней мере одно управление указанного типа поддерживается, в противном случае false.

getControl

Control getControl(Control.Type control)

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

Параметры:

control - тип запрошенного управления

Возвращает:

управление указанного типа

Исключения:

IllegalArgumentException - если управление указанного типа не поддерживается

См. также:

getControls(), isControlSupported(Control.Type control)

addLineListener

void addLineListener(LineListener listener)

Добавляет слушателя к этой линии. Всякий раз, когда изменяется состояние линии, метод update() слушателя вызывается с объектом LineEvent, который описывает изменение.

Параметры:

listener - объект, который нужно добавить в качестве слушателя к этой линии

См. также:

removeLineListener(javax.sound.sampled.LineListener), LineListener.update(javax.sound.sampled.LineEvent), LineEvent

removeLineListener

void removeLineListener(LineListener listener)

Удаляет указанного слушателя из списка слушателей этой линии.

Параметры:

listener - слушатель для удаления

См. также:

addLineListener(javax.sound.sampled.LineListener)