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

クラスDataLine.Info

  • 含まれているインタフェース:
    DataLine
    public static class DataLine.Info
extends Line.Info
    スーパー・クラスから継承されたクラス情報以外に、DataLine.Infoはデータ・ラインに固有の追加情報を提供します。 追加情報には次のものがあります。
    • データ・ラインでサポートされるオーディオ形式
    • その内部バッファの最小サイズと最大サイズ
    Line.Infoは、その記述する行のクラスを知っているので、DataLine.Infoオブジェクトは、SourceDataLine、TargetDataLine、およびClipなどのDataLineサブインタフェースを記述できます。 ミキサーに対して、これらのタイプのラインの有無を照会して、DataLine.Infoの適切なインスタンスをMixer.getLine(Line.Info)などのメソッドに引数として渡すことができます。
    導入されたバージョン:
    1.3
    関連項目:
    Line.Info

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

      コンストラクタ 
      コンストラクタ 説明
      Info​(Class<?> lineClass, AudioFormat format)
      単一のオーディオ形式を含む指定した情報からデータ・ラインの情報オブジェクトを構築します。
      Info​(Class<?> lineClass, AudioFormat[] formats, int minBufferSize, int maxBufferSize)
      サポートされるオーディオ形式およびバッファ・サイズの範囲を含む指定した情報からデータ・ラインの情報オブジェクトを構築します。
      Info​(Class<?> lineClass, AudioFormat format, int bufferSize)
      単一のオーディオ形式および必要なバッファ・サイズを含む指定した情報からデータ・ラインの情報オブジェクトを構築します。

    • コンストラクタの詳細

      • Info

        public Info​(Class<?> lineClass,
            AudioFormat[] formats,
            int minBufferSize,
            int maxBufferSize)
        サポートされるオーディオ形式およびバッファ・サイズの範囲を含む指定した情報からデータ・ラインの情報オブジェクトを構築します。 通常、このコンストラクタは、サポートされるラインに関する情報を返すときのミキサー実装で使用されます。
        パラメータ:
        lineClass - 情報オブジェクトによって記述されるデータ・ラインのクラス
        formats - サポートされる形式のセット
        minBufferSize - データ・ラインでサポートされる最小バッファ・サイズ(バイト数)
        maxBufferSize - データ・ラインでサポートされる最大バッファ・サイズ(バイト数)

      • Info

        public Info​(Class<?> lineClass,
            AudioFormat format,
            int bufferSize)
        単一のオーディオ形式および必要なバッファ・サイズを含む指定した情報からデータ・ラインの情報オブジェクトを構築します。 このコンストラクタは通常、アプリケーションが目的のラインを記述するのに使用します。
        パラメータ:
        lineClass - 情報オブジェクトによって記述されるデータ・ラインのクラス
        format - 必要な形式
        bufferSize - 希望のバッファ・サイズ(バイト単位)

      • Info

        public Info​(Class<?> lineClass,
            AudioFormat format)
        単一のオーディオ形式を含む指定した情報からデータ・ラインの情報オブジェクトを構築します。 このコンストラクタは通常、アプリケーションが目的のラインを記述するのに使用します。
        パラメータ:
        lineClass - 情報オブジェクトによって記述されるデータ・ラインのクラス
        format - 必要な形式

    • メソッドの詳細

      • getFormats

        public AudioFormat[] getFormats()
        データ・ラインによってサポートされるオーディオ形式のセットを取得します。 isFormatSupported(AudioFormat)は、getFormats()によって返されたセットにはない特定の追加形式の場合にtrueを返すことがあります。 その逆は成り立ちません。isFormatSupported(AudioFormat)は、getFormats()によって返されたすべての形式についてtrueを返すことが保証されています。

        AudioFormatインスタンスの一部のフィールドは、そのフィールドがフォーマットに適用されない場合、またはそのフォーマットがそのフィールドの広範囲の値をサポートする場合、NOT_SPECIFIEDに設定することができます。 たとえば、最大64チャネルをサポートするマルチチャネル・デバイスでは、このメソッドから返されるAudioFormatインスタンスのチャネル・フィールドをNOT_SPECIFIEDに設定できます。

        戻り値:
        サポートされるオーディオ形式のセット
        関連項目:
        isFormatSupported(AudioFormat)

      • isFormatSupported

        public boolean isFormatSupported​(AudioFormat format)
        このデータ・ラインが特定のオーディオ形式をサポートするかどうかを示します。 このメソッドのデフォルトの実装では、指定された形式がサポートされる形式のどれかに一致すると単純にtrueを返します。
        パラメータ:
        format - サポートについて照会するオーディオ形式
        戻り値:
        形式がサポートされている場合はtrue、そうでない場合はfalse
        関連項目:
        getFormats(), AudioFormat.matches(javax.sound.sampled.AudioFormat)

      • getMinBufferSize

        public int getMinBufferSize()
        データ・ラインでサポートされる最小バッファ・サイズを取得します。
        戻り値:
        最小バッファ・サイズ(バイト数)、またはAudioSystem.NOT_SPECIFIED

      • getMaxBufferSize

        public int getMaxBufferSize()
        データ・ラインでサポートされる最大バッファ・サイズを取得します。
        戻り値:
        最大バッファ・サイズ(バイト数)、またはAudioSystem.NOT_SPECIFIED

      • matches

        public boolean matches​(Line.Info info)
        指定された情報オブジェクトがこのオブジェクトに一致するかどうかを判定します。 一致するためには、スーパー・クラスの一致要件が合致する必要があります。 さらに、このオブジェクトの最小バッファ・サイズは指定されたオブジェクトの最小サイズ以上の大きさにし、またその最大バッファ・サイズは指定されたオブジェクトの最大サイズ以下の大きさにする必要があります。またその形式のすべてが、指定されたオブジェクトでサポートされる形式と一致する必要があります。
        オーバーライド:
        matches、クラス: Line.Info
        パラメータ:
        info - このオブジェクトと比較されている情報オブジェクト
        戻り値:
        指定されたオブジェクトがこのオブジェクトに一致する場合はtrue、そうでない場合はfalse

      • toString

        public String toString()
        データ・ライン情報のテキスト記述を取得します。
        オーバーライド:
        toString、クラス: Line.Info
        戻り値:
        文字列説明