Класс FormatConversionProvider

public abstract class FormatConversionProvider
extends Object

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

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

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

Конструкторы

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

isTargetEncodingSupported

public boolean isTargetEncodingSupported(AudioFormat.Encoding targetEncoding)

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

Параметры:

targetEncoding - кодировка целевого формата, для которой запрашивается поддержка

Возвращает:

true , если кодировка поддерживается, в противном случае false

getTargetEncodings

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

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

Параметры:

sourceFormat - формат входящих данных

Возвращает:

массив поддерживаемых кодировок целевого формата.

isConversionSupported

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

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

Параметры:

targetEncoding - желаемая кодировка исходящих данных

sourceFormat - формат входящих данных

Возвращает:

true , если преобразование поддерживается, в противном случае false

getTargetFormats

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

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

Параметры:

targetEncoding - желаемая кодировка потока после обработки

sourceFormat - формат входящих данных

Возвращает:

массив поддерживаемых целевых форматов.

isConversionSupported

public boolean isConversionSupported(AudioFormat targetFormat,
                                     AudioFormat sourceFormat)

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

Параметры:

targetFormat - желаемый формат исходящих данных

sourceFormat - формат входящих данных

Возвращает:

true , если преобразование поддерживается, в противном случае false

getAudioInputStream

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

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

Параметры:

targetEncoding - желаемая кодировка потока после обработки

sourceStream - поток, из которого должны читаться данные для обработки

Возвращает:

поток, из которого можно считать обработанные данные с указанной целевой кодировкой

Исключения:

IllegalArgumentException - если комбинация форматов не поддерживается.

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(AudioFormat targetFormat,
                                                     AudioInputStream sourceStream)

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

Параметры:

targetFormat - желаемый формат данных потока после обработки

sourceStream - поток, из которого должны читаться данные для обработки

Возвращает:

поток, из которого можно считать обработанные данные с указанным форматом

Исключения:

IllegalArgumentException - если комбинация форматов не поддерживается.