Класс 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

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

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/sampled/DataLine.Info.html