Класс 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()`	Возвращает строковое представление объекта информации.

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

getLineClass

Методы, объявленные в классе java.lang.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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/sampled/DataLine.Info.html