javax.sound.sampled

クラス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

関連項目:

Line.Info

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

コンストラクタ

コンストラクタと説明
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() データ・ライン情報のテキスト記述を取得します。

クラス javax.sound.sampled.Line.Infoから継承されたメソッド

getLineClass

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

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

戻り値:

文字列説明