javax.sound.sampled.spi
類別 FormatConversionProvider

java.lang.Object
  javax.sound.sampled.spi.FormatConversionProvider

public abstract class FormatConversionProvider
extends Object

格式轉換提供者提供從一種或多種輸入格式到一種或多種輸出格式的格式轉換服務。轉換器包括編碼器（編碼或解碼音頻資料）和程式碼轉換器等。格式轉換器提供確定所支持的轉換方法和從可以讀取的轉換資料獲得音頻串流的方法。

源格式表示要轉換的轉入音頻資料的格式。

目標格式表示已處理的、已轉換的音頻資料的格式。這是可以從由某個 getAudioInputStream 方法返回的串流中讀取的資料的格式。

從以下版本開始：

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()

獲得源格式編碼的集合，此提供者從該集合中提供格式轉換服務。

返回：

源格式編碼的陣列。陣列將始終具有至少為 1 的長度。

getTargetEncodings

public abstract AudioFormat.Encoding[] getTargetEncodings()

獲得目標格式編碼的集合，此提供者向該集合提供格式轉換服務。

返回：

目標格式編碼的陣列。陣列將始終具有至少為 1 的長度。

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 的陣列。

返回：

受支持的目標格式編碼的陣列。

isConversionSupported

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

指示格式轉換器是否支持從特定格式向特定編碼的轉換。

參數：

argetEncoding - 傳出資料所需的編碼

sourceFormat - 傳入資料的格式

返回：

如果轉換受支持，則返回 true；否則返回 false

getTargetFormats

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

獲得具有受格式轉換器支持的指定編碼的目標格式集合。如果沒有為此源格式受支持的具有指定編碼的目標格式，則返回一個長度為 0 的陣列。

返回：

受支持的目標格式的陣列。

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