モジュール java.desktop

パッケージ javax.sound.sampled.spi

クラスFormatConversionProvider

java.lang.Object

javax.sound.sampled.spi.FormatConversionProvider

public abstract class FormatConversionProvider extends Object

形式変換プロバイダは、1つ以上の入力形式から1つ以上の出力形式への形式変換サービスを提供します。 コンバータには、オーディオ・データのエンコードまたはデコード、あるいはその両方を行うcodec、トランスコーダーなどが含まれます。形式コンバータは、サポートされる変換の判別、および変換されたデータを読み込めるオーディオ・ストリームを取得するためのメソッドを提供します。

ソース形式は着信オーディオ・データの形式を表します。この形式は変換されます。

ターゲット形式は、処理済みの変換されたオーディオ・データの形式です。 これは、getAudioInputStreamメソッドの1つによって返されたストリームから読み込めるデータの形式です。

導入されたバージョン:

1.3

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	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

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の場合