Класс FormatConversionProvider

java.lang.Object

javax.sound.sampled.spi.FormatConversionProvider

public abstract class FormatConversionProvider extends Object

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

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

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

Since:: 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, 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/spi/FormatConversionProvider.html