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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в одной из будущих версий. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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.