Класс FormatConversionProvider

java.lang.Object

javax.sound.sampled.spi.FormatConversionProvider

public abstract class FormatConversionProvider extends Object

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

Исходный формат представляет формат входящих аудиоданных, которые будут преобразованы.

Целевой формат представляет формат обработанных, преобразованных аудиоданных. Это формат данных, которые можно считывать из потока, возвращаемого одним из методов getAudioInputStream.

Начиная с версии:: 1.3

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

FormatConversionProvider()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова из подклассов.

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

Модификатор и тип	Метод	Описание
`abstract AudioInputStream`	`getAudioInputStream(AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream)`	Получает аудиопоток ввода с указанной кодировкой из заданного аудиопотока ввода.
`abstract AudioInputStream`	`getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream)`	Получает аудиопоток ввода с указанным форматом из заданного аудиопотока ввода.
`abstract AudioFormat.Encoding[]`	`getSourceEncodings()`	Получает набор кодировок исходных форматов, для которых этот поставщик предоставляет службы преобразования форматов.
`abstract AudioFormat.Encoding[]`	`getTargetEncodings()`	Получает набор кодировок целевых форматов, в которые этот поставщик предоставляет службы преобразования форматов.
`abstract AudioFormat.Encoding[]`	`getTargetEncodings(AudioFormat sourceFormat)`	Получает набор кодировок целевых форматов, поддерживаемых преобразователем форматов для заданного исходного формата.
`abstract AudioFormat[]`	`getTargetFormats(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)`	Получает набор целевых форматов с указанной кодировкой, поддерживаемых преобразователем форматов.
`boolean`	`isConversionSupported(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)`	Указывает, поддерживает ли преобразователь форматов преобразование из заданного формата в указанную кодировку.
`boolean`	`isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat)`	Указывает, поддерживает ли преобразователь форматов преобразование из одного заданного формата в другой.
`boolean`	`isSourceEncodingSupported(AudioFormat.Encoding sourceEncoding)`	Указывает, поддерживает ли преобразователь форматов преобразование из указанной кодировки исходного формата.
`boolean`	`isTargetEncodingSupported(AudioFormat.Encoding targetEncoding)`	Указывает, поддерживает ли преобразователь форматов преобразование в указанную кодировку целевого формата.

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

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

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

FormatConversionProvider

protected FormatConversionProvider()

Конструктор для вызова из подклассов.

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

getSourceEncodings

public abstract AudioFormat.Encoding[] getSourceEncodings()

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

Возвращает:: массив кодировок исходных форматов. Если по какой-либо причине поставщик не предоставляет служб преобразования, возвращается массив длины 0.

getTargetEncodings

public abstract AudioFormat.Encoding[] getTargetEncodings()

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

Возвращает:: массив кодировок целевых форматов. Если по какой-либо причине поставщик не предоставляет служб преобразования, возвращается массив длины 0.

isSourceEncodingSupported

public boolean isSourceEncodingSupported(AudioFormat.Encoding sourceEncoding)

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

Параметры:: sourceEncoding — кодировка исходного формата, для которой проверяется поддержка
Возвращает:: true, если кодировка поддерживается, иначе false
Выбрасывает:: NullPointerException — если sourceEncoding имеет значение null

isTargetEncodingSupported

public boolean isTargetEncodingSupported(AudioFormat.Encoding targetEncoding)

Указывает, поддерживает ли преобразователь форматов преобразование в указанную кодировку целевого формата.

Параметры:: targetEncoding — кодировка целевого формата, для которой проверяется поддержка
Возвращает:: true, если кодировка поддерживается, иначе false
Выбрасывает:: NullPointerException — если targetEncoding имеет значение null

getTargetEncodings

public abstract AudioFormat.Encoding[] getTargetEncodings(AudioFormat sourceFormat)

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

Параметры:: sourceFormat — формат входящих данных
Возвращает:: массив поддерживаемых кодировок целевых форматов
Выбрасывает:: NullPointerException — если sourceFormat имеет значение null

isConversionSupported

public boolean isConversionSupported(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)

Указывает, поддерживает ли преобразователь форматов преобразование из заданного формата в указанную кодировку.

Параметры:: targetEncoding — требуемая кодировка выходящих данных; sourceFormat — формат входящих данных
Возвращает:: true, если преобразование поддерживается, иначе false
Выбрасывает:: NullPointerException — если targetEncoding или sourceFormat имеют значение null

getTargetFormats

public abstract AudioFormat[] getTargetFormats(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)

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

Параметры:: targetEncoding — требуемая кодировка потока после обработки; sourceFormat — формат входящих данных
Возвращает:: массив поддерживаемых целевых форматов
Выбрасывает:: NullPointerException — если targetEncoding или sourceFormat имеют значение null

isConversionSupported

public boolean isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat)

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

Параметры:: targetFormat — требуемый формат выходящих данных; sourceFormat — формат входящих данных
Возвращает:: true, если преобразование поддерживается, иначе false
Выбрасывает:: NullPointerException — если targetFormat или sourceFormat имеют значение null

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream)

Получает аудиопоток ввода с указанной кодировкой из заданного аудиопотока ввода.

Параметры:: targetEncoding — требуемая кодировка потока после обработки; sourceStream — поток, из которого следует считывать данные для обработки
Возвращает:: поток, из которого можно считывать обработанные данные с указанной целевой кодировкой
Выбрасывает:: IllegalArgumentException — если заданная комбинация форматов не поддерживается; NullPointerException — если targetEncoding или sourceStream имеют значение null

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream)

Получает аудиопоток ввода с указанным форматом из заданного аудиопотока ввода.

Параметры:: targetFormat — требуемый формат данных потока после обработки; sourceStream — поток, из которого следует считывать данные для обработки
Возвращает:: поток, из которого можно считывать обработанные данные с указанным форматом
Выбрасывает:: IllegalArgumentException — если заданная комбинация форматов не поддерживается; NullPointerException — если targetFormat или sourceStream имеют значение null

© 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/spi/FormatConversionProvider.html