クラス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)
    指定されたターゲット形式エンコーディングへの変換を形式コンバータがサポートしているかどうかを示します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

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