モジュール java.desktop
パッケージ javax.sound.sampled.spi

クラスFormatConversionProvider


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

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

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

    導入されたバージョン:
    1.3

    • コンストラクタの詳細

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