javax.sound.sampled

Интерфейсная Строка

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

AutoCloseable

Все Известные Подынтерфейсы:

Клип, DataLine, Микшер, Порт, SourceDataLine, TargetDataLine

public interface Line
extends AutoCloseable

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

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

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

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

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

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

С тех пор:

1.3

См. Также:

LineEvent

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

Вложенные Классы

Модификатор и Тип	Интерфейс и Описание
static class	Строка. Информация A Line.Info объект содержит информацию о строке.

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

Методы

Модификатор и Тип	Метод и Описание
void	addLineListener(LineListener listener) Добавляет слушатель этой строки.
void	close() Закрывает строку, указывая, что любые системные ресурсы в использовании строкой могут быть выпущены.
Управление	getControl(Control.Type control) Получает управление указанного типа, если есть кто-либо.
Управление[]	getControls() Получает набор средств управления, связанных с этой строкой.
Строка. Информация	getLineInfo() Получает Line.Info объект, описывающий эту строку.
boolean	isControlSupported(Control.Type control) Указывает, поддерживает ли строка управление указанного типа.
boolean	isOpen() Указывает, открыта ли строка, означая, что она зарезервировала системные ресурсы и является операционной, хотя она не могла бы в настоящий момент играть или получать звук.
void	open() Открывает строку, указывая, что она должна получить любые необходимые системные ресурсы и стать операционной.
void	removeLineListener(LineListener listener) Удаляет указанного слушателя из списка этой строки слушателей.

Деталь метода

getLineInfo

Line.Info getLineInfo()

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

Возвраты:

описание строки

открытый

void open()
          throws LineUnavailableException

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

Отметьте, что некоторые строки, когда-то закрытые, не могут быть вновь открыты. Попытки вновь открыть такую строку будут всегда приводить к LineUnavailableException.

У некоторых типов строк есть конфигурируемые свойства, которые могут влиять на распределение ресурсов. Например, a DataLine должен быть открыт с определенным форматом и размером буфера. Такие строки должны обеспечить механизм для того, чтобы он сконфигурировал эти свойства, такой как дополнительное open метод или методы, которые позволяют приложению определять требуемые настройки.

Этот метод не берет параметров, и открывает строку с текущими настройками. Для SourceDataLine и TargetDataLine объекты, это означает, что строка открывается с настройками по умолчанию. Для a Clip, однако, размер буфера определяется, когда данные загружаются. Так как этот метод не позволяет приложению определять любые данные, чтобы загрузиться, IllegalArgumentException бросается. Поэтому, следует вместо этого использовать один из open методы, обеспеченные в Clip взаимодействуйте через интерфейс, чтобы загрузить данные в Clip.

Для DataLine's, если DataLine.Info объект, который использовался, чтобы получить строку, определяет по крайней мере один полностью определенный аудиоформат, последний будет использоваться в качестве формата по умолчанию.

Броски:

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

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

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

См. Также:

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

близко

void close()

Закрывает строку, указывая, что любые системные ресурсы в использовании строкой могут быть выпущены. Если эта работа успешно выполняется, строка отмечается закрытая и a 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() метод вызывают с a 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)