javax.sound.sampled
类 AudioFileFormat

java.lang.Object
  javax.sound.sampled.AudioFileFormat

public class AudioFileFormat
extends Object

AudioFileFormat 类的实例描述音频文件，包括文件类型、文件长度（以字节为单位）、文件中包含的音频数据的长度（以示例帧为单位），以及音频数据的格式。

AudioSystem 类包括确定音频文件格式的方法、从音频文件获得音频输入流的方法，以及从音频输入流写入音频文件的方法。

AudioFileFormat 对象可以包括属性的集合。属性是一对键和值：键的类型是 String，其关联属性值是任意对象。属性指定其他信息元数据（如作者、版权和文件期限）。属性是可选信息，不需要文件 reader 和文件 writer 实现来提供或识别属性。

下表列出了一些应该在实现中使用的常见属性：

属性键	值类型	描述
“期限”	Long	以微秒为单位的文件回放期限
“作者”	String	此文件的作者姓名
“标题”	String	此文件的标题
“版权”	String	版权消息
“日期”	Date	录制或发行日期
“注释”	String	任意文本

从以下版本开始：

1.3

另请参见：

AudioInputStream

嵌套类摘要

static class

AudioFileFormat.Type Type 类的实例表示音频文件的标准类型之一。

构造方法摘要

	AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength) 构造音频文件格式对象。
	AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength, Map<String,Object> properties) 构造具有定义的属性集合的音频文件格式对象。
protected	AudioFileFormat(AudioFileFormat.Type type, int byteLength, AudioFormat format, int frameLength) 构造音频文件格式对象。

方法摘要

int	getByteLength() 获得以字节为单位的整个文件（不只是其音频数据）的大小。
AudioFormat	getFormat() 获得音频文件中包含的音频数据的格式。
int	getFrameLength() 获得文件中包含的音频数据的长度，以示例帧为单位表示。
Object	getProperty(String key) 获得键指定的属性值。
AudioFileFormat.Type	getType() 获得音频文件类型，如 WAVE 或 AU。
Map<String,Object>	properties() 获得不可修改的属性映射。
String	toString() 提供文件格式的字符串表示形式。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

AudioFileFormat

protected AudioFileFormat(AudioFileFormat.Type type,
                          int byteLength,
                          AudioFormat format,
                          int frameLength)

构造音频文件格式对象。此受保护的构造方法旨在返回音频文件或受支持音频文件格式的信息时供文件读取服务的提供程序使用。

参数：

type - 音频文件的类型

byteLength - 以字节为单位的文件长度，或 AudioSystem.NOT_SPECIFIED

format - 文件中包含的音频文件的格式

frameLength - 以示例帧为单位的音频数据的长度，或 AudioSystem.NOT_SPECIFIED

另请参见：

getType()

AudioFileFormat

public AudioFileFormat(AudioFileFormat.Type type,
                       AudioFormat format,
                       int frameLength)

构造音频文件格式对象。应用程序可以使用此公共构造方法描述请求的音频文件的属性。

参数：

type - 音频文件的类型

format - 文件中包含的音频数据的格式

frameLength - 以示例帧为单位的音频数据的长度，或 AudioSystem.NOT_SPECIFIED

AudioFileFormat

public AudioFileFormat(AudioFileFormat.Type type,
                       AudioFormat format,
                       int frameLength,
                       Map<String,Object> properties)

构造具有定义的属性集合的音频文件格式对象。应用程序可以使用此公共构造方法描述请求的音频文件的属性。复制属性映射以防对其进行更改。

参数：

type - 音频文件的类型

format - 文件中包含的音频数据的格式

frameLength - 以示例帧为单位的音频数据的长度，或 AudioSystem.NOT_SPECIFIED

properties - 带属性的 Map<String,Object> 对象

从以下版本开始：

1.5

方法详细信息

getType

public AudioFileFormat.Type getType()

获得音频文件类型，如 WAVE 或 AU。

返回：

音频文件类型

另请参见：

AudioFileFormat.Type.WAVE, AudioFileFormat.Type.AU, AudioFileFormat.Type.AIFF, AudioFileFormat.Type.AIFC, AudioFileFormat.Type.SND

getByteLength

public int getByteLength()

获得以字节为单位的整个文件（不只是其音频数据）的大小。

返回：

以字节为单位的音频文件的长度

另请参见：

AudioSystem.NOT_SPECIFIED

getFormat

public AudioFormat getFormat()

获得音频文件中包含的音频数据的格式。

返回：

音频数据的格式

getFrameLength

public int getFrameLength()

获得文件中包含的音频数据的长度，以示例帧为单位表示。

返回：

文件中音频数据的示例帧数

另请参见：

AudioSystem.NOT_SPECIFIED

properties

public Map<String,Object> properties()

获得不可修改的属性映射。属性的概念在类描述进一步解释。

返回：

包含所有属性的 Map<String,Object> 对象。如果不能识别任何属性，则返回空映射。

从以下版本开始：

1.5

另请参见：

getProperty(String)

getProperty

public Object getProperty(String key)

获得键指定的属性值。属性的概念在类描述进一步解释。

如果指定属性不是为特定文件格式定义的，则此方法返回 null。

参数：

key - 所需属性的键

返回：

具有指定键的属性值；如果属性不存在，则返回 null。

从以下版本开始：

1.5

另请参见：

properties

toString

public String toString()

提供文件格式的字符串表示形式。

覆盖：

类 Object 中的 toString

返回：

以字符串表示的文件格式