Класс 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, 2023, 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/21/docs/api/java.desktop/javax/sound/sampled/DataLine.Info.html