Класс FormatConversionProvider

public abstract class FormatConversionProvider
extends Object

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

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

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

Since:
1.3

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

Конструктор Описание
FormatConversionProvider()

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

Модификатор и тип Метод Описание
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

public 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, 2020, 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/11/docs/api/java.desktop/javax/sound/sampled/spi/FormatConversionProvider.html

Spec-Zone .ru
спецификации, руководства, описания, API