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

См. также:

Line.Info

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

Конструктор	Описание
`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(AudioFormat)

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, 2021, 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/17/docs/api/java.desktop/javax/sound/sampled/DataLine.Info.html