クラスDataLine.Info

java.lang.Object
javax.sound.sampled.Line.Info
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
関連項目:

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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    AudioFormat[]
    getFormats()
    データ・ラインによってサポートされるオーディオ形式のセットを取得します。
    int
    getMaxBufferSize()
    データ・ラインでサポートされる最大バッファ・サイズを取得します。
    int
    getMinBufferSize()
    データ・ラインでサポートされる最小バッファ・サイズを取得します。
    boolean
    isFormatSupported(AudioFormat format)
    このデータ・ラインが特定のオーディオ形式をサポートするかどうかを示します。
    boolean
    matches(Line.Info info)
    指定された情報オブジェクトがこのオブジェクトに一致するかどうかを判定します。
    String
    toString()
    情報オブジェクトの文字列表現を返します。

    クラスで宣言されたメソッド Line.Info

    getLineClass
    修飾子と型
    メソッド
    説明
    Class<?>
    getLineClass()
    このLine.Infoオブジェクトが記述する行のクラスを取得します。

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

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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

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

    • 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
      戻り値:
      情報オブジェクトの文字列表現