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 物件可以描述 DataLine 子介面（比如 SourceDataLine、TargetDataLine 和 Clip）。通過將 DataLine.Info 的適當實例作為參數傳遞到某一方法（如 Mixer.getLine(Line.Info)），可以查詢任何型別的行混頻器。

從以下版本開始：

1.3

另請參見：

Line.Info

建構子摘要

DataLine.Info(Class<?> lineClass, AudioFormat format)
根據指定資訊建構資料行的資訊物件，這些資訊包括單個音頻格式。

DataLine.Info(Class<?> lineClass, AudioFormat[] formats, int minBufferSize, int maxBufferSize)
根據指定資訊建構資料行的資訊物件，這些包括受支持音頻格式的集合和緩衝區大小的範圍。

DataLine.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

建構子詳細資訊

DataLine.Info

public DataLine.Info(Class<?> lineClass,
                     AudioFormat[] formats,
                     int minBufferSize,
                     int maxBufferSize)

根據指定資訊建構資料行的資訊物件，這些包括受支持音頻格式的集合和緩衝區大小的範圍。此建構子通常在返回受支持行的資訊時由混頻器實作使用。

參數：

lineClass - 該資訊物件描述的資料行的類別

formats - 受支持格式的集合

minBufferSize - 資料行支持的最小緩衝區大小（以位元組為單位）

maxBufferSize - 資料行支持的最大緩衝區大小（以位元組為單位）

DataLine.Info

public DataLine.Info(Class<?> lineClass,
                     AudioFormat format,
                     int bufferSize)

根據指定資訊建構資料行的資訊物件，這些資訊包括單個音頻格式和所需的緩衝區大小。此建構子通常由應用程序用於描述所需的行。

參數：

lineClass - 該資訊物件描述的資料行的類別

format - 所需的格式

bufferSize - 所需的緩衝區大小（以位元組為單位）

DataLine.Info

public DataLine.Info(Class<?> lineClass,
                     AudioFormat format)

根據指定資訊建構資料行的資訊物件，這些資訊包括單個音頻格式。此建構子通常由應用程序用於描述所需的行。

參數：

lineClass - 該資訊物件所描述的資料行的類別

format - 所需的格式

方法詳細資訊

getFormats

public AudioFormat[] getFormats()

獲得資料行支持的音頻格式的集合。注意，isFormatSupported(AudioFormat) 可能為某種其他格式返回 true，這些格式是從 getFormats() 返回的集合中丟失的。反之則不然：保證 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)

確定指定的資訊物件是否與此物件比對。若要比對，則必須滿足父級類別比對要求。此外，該物件的最小緩衝區大小必須至少與指定物件的緩衝區大小相同，其最大緩衝區大小必須至多與指定物件的緩衝區大小相同，並且它的所有格式都必須與指定物件支持的格式比對。

覆寫：

類別 Line.Info 中的 matches

參數：

info - 要與此物件比較的 info 物件

返回：

如果此物件與指定的物件比對，則返回 true；否則返回 false。

toString

public String toString()

獲得資料行資訊的文本描述。

覆寫：

類別 Line.Info 中的 toString

返回：

字元串描述