DataLine.Info (Java Platform SE 6)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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
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)