Класс 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)`	Указывает, поддерживает ли преобразователь форматов преобразование в заданную кодировку целевого формата.

Методы, объявленные в классе java.lang.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, 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/spi/FormatConversionProvider.html