Класс DataLine.Info

java.lang.Object

javax.sound.sampled.Line.Info

javax.sound.sampled.DataLine.Info

Вмещающий интерфейс:: DataLine

public static class DataLine.Info extends Line.Info

Помимо сведений о классе, унаследованных от суперкласса, DataLine.Info предоставляет дополнительные сведения, относящиеся к линиям данных. Эти сведения включают:

аудиоформаты, поддерживаемые линией данных
минимальный и максимальный размеры внутреннего буфера

Поскольку Line.Info знает класс описываемой им линии, объект DataLine.Info может описывать подинтерфейсы DataLine, такие как SourceDataLine, TargetDataLine и Clip. Можно запрашивать у микшера линии любого из этих типов, передавая соответствующий экземпляр DataLine.Info в качестве аргумента такому методу, как Mixer.getLine(Line.Info).

С момента выпуска:

1.3

См. также:

Краткое описание конструкторов

Конструктор	Описание
`Info(Class<?> lineClass, AudioFormat format)`	Создает объект сведений о линии данных на основе указанной информации, включающей один аудиоформат.
`Info(Class<?> lineClass, AudioFormat[] formats, int minBufferSize, int maxBufferSize)`	Создает объект сведений о линии данных на основе указанной информации, включающей набор поддерживаемых аудиоформатов и диапазон размеров буфера.
`Info(Class<?> lineClass, AudioFormat format, int bufferSize)`	Создает объект сведений о линии данных на основе указанной информации, включающей один аудиоформат и требуемый размер буфера.

Краткое описание методов

Модификатор и тип	Метод	Описание
`AudioFormat[]`	`getFormats()`	Получает набор аудиоформатов, поддерживаемых линией данных.
`int`	`getMaxBufferSize()`	Получает максимальный размер буфера, поддерживаемый линией данных.
`int`	`getMinBufferSize()`	Получает минимальный размер буфера, поддерживаемый линией данных.
`boolean`	`isFormatSupported(AudioFormat format)`	Показывает, поддерживает ли эта линия данных указанный аудиоформат.
`boolean`	`matches(Line.Info info)`	Определяет, соответствует ли указанный объект сведений этому объекту.
`String`	`toString()`	Возвращает строковое представление объекта сведений.

Методы, объявленные в классе Line.Info

getLineClass

Модификатор и тип	Метод	Описание
`Class<?>`	`getLineClass()`	Получает класс линии, описываемой этим объектом `Line.Info`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, «равен ли» этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

Info

public Info(Class<?> lineClass, AudioFormat[] formats, int minBufferSize, int maxBufferSize)

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

Параметры:: lineClass — класс линии данных, описываемой объектом сведений; formats — набор поддерживаемых форматов; minBufferSize — минимальный размер буфера, поддерживаемый линией данных, в байтах; maxBufferSize — максимальный размер буфера, поддерживаемый линией данных, в байтах

Info

public Info(Class<?> lineClass, AudioFormat format, int bufferSize)

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

Параметры:: lineClass — класс линии данных, описываемой объектом сведений; format — требуемый формат; bufferSize — требуемый размер буфера, в байтах

Info

public Info(Class<?> lineClass, AudioFormat format)

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

Параметры:: lineClass — класс линии данных, описываемой объектом сведений; format — требуемый формат

Подробное описание методов

getFormats

public AudioFormat[] getFormats()

Получает набор аудиоформатов, поддерживаемых линией данных. Обратите внимание, что isFormatSupported(AudioFormat) может возвращать true для некоторых дополнительных форматов, отсутствующих в наборе, возвращаемом getFormats(). Обратное неверно: isFormatSupported(AudioFormat) гарантированно возвращает true для всех форматов, возвращаемых getFormats().

Некоторые поля в экземплярах AudioFormat могут быть установлены в NOT_SPECIFIED, если это поле не применимо к формату или если формат поддерживает широкий диапазон значений этого поля. Например, многоканальное устройство, поддерживающее до 64 каналов, может установить поле каналов в экземплярах AudioFormat, возвращаемых этим методом, в значение NOT_SPECIFIED.

Возвращает:

набор поддерживаемых аудиоформатов

См. также:

isFormatSupported

public boolean isFormatSupported(AudioFormat format)

Показывает, поддерживает ли эта линия данных указанный аудиоформат. Реализация этого метода по умолчанию просто возвращает true, если указанный формат соответствует одному из поддерживаемых форматов.

Параметры:

format — аудиоформат, поддержку которого нужно проверить

Возвращает:

true, если формат поддерживается, иначе false

См. также:

getMinBufferSize

public int getMinBufferSize()

Получает минимальный размер буфера, поддерживаемый линией данных.

Возвращает:: минимальный размер буфера в байтах или AudioSystem.NOT_SPECIFIED

getMaxBufferSize

public int getMaxBufferSize()

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

Возвращает:: максимальный размер буфера в байтах или AudioSystem.NOT_SPECIFIED

matches

public boolean matches(Line.Info info)

Определяет, соответствует ли указанный объект сведений этому объекту. Для соответствия должны выполняться условия соответствия суперкласса. Кроме того, минимальный размер буфера этого объекта должен быть не меньше минимального размера буфера указанного объекта, максимальный размер буфера должен быть не больше максимального размера буфера указанного объекта, а все форматы этого объекта должны соответствовать форматам, поддерживаемым указанным объектом.

Переопределяет:: matches в классе Line.Info
Параметры:: info — объект сведений, с которым сравнивается этот объект
Возвращает:: true, если этот объект соответствует указанному, иначе false

toString

public String toString()

Возвращает строковое представление объекта сведений.

Переопределяет:: toString в классе Line.Info
Возвращает:: строковое представление объекта сведений

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.