javax.sound.sampled.spi

Class FormatConversionProvider

java.lang.Object

javax.sound.sampled.spi.FormatConversionProvider

public abstract class FormatConversionProvider
extends Object

格式转换提供程序从一个或多个输入格式提供格式转换服务到一个或多个输出格式。转换器包括编解码、编码/解码的音频数据，以及转码器等格式转换器提供的方法确定支持什么样的转换和获取的音频流转换后的数据可以被读取。

源格式表示传入的音频数据的格式，该格式将被转换。

目标格式表示处理的、转换的音频数据的格式。这是格式的数据，可以从流中读取的getAudioInputStream方法返回。

从以下版本开始：

一点三

构造方法摘要

构造方法

Constructor and Description
FormatConversionProvider()

方法摘要

Modifier and Type	Method and Description
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) 如果没有指定的编码的目标格式与此源格式的支持，如果没有指定的编码的目标格式，则返回一个长度为0的数组，获取该格式转换器的指定的目标格式集。
boolean	isConversionSupported(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat) 指示格式转换器是否支持从特定格式转换为特定的编码格式。
boolean	isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat) 指示格式转换器是否支持从另一个特定格式转换为一个特定格式的格式转换器。
boolean	isSourceEncodingSupported(AudioFormat.Encoding sourceEncoding) 指示格式转换器是否支持从指定的源格式编码的转换。
boolean	isTargetEncodingSupported(AudioFormat.Encoding targetEncoding) 指示格式转换器是否支持转换到指定的目标格式编码。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

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如果格式组合提供的是不支持的。