javax.sound.sampled

Class AudioFileFormat

java.lang.Object

javax.sound.sampled.AudioFileFormat

public class AudioFileFormat
extends Object

该 AudioFileFormat类的一个实例介绍了音频文件，包括文件类型，文件的字节长度，在文件中包含的音频样本数据帧的长度，和音频数据格式。

的AudioSystem类包括确定音频文件格式的方法，从音频文件中获取音频输入流，从音频输入流写入一个音频文件。

一个AudioFileFormat对象可以包括一组属性。房地产是一对键和值：关键是String型，相关的属性值是一个任意的对象。属性指定额外的信息元数据（如作者、版权或文件持续时间）。属性是可选的信息，而文件阅读器和文件写入器实现不需要提供或识别属性。

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

Audio File Format Properties

Property key	Value type	描述
"duration"	Long	playback duration of the file in microseconds
"author"	String	name of the author of this file
"title"	String	title of this file
"copyright"	String	copyright message
"date"	Date	date of the recording or release
"comment"	String	an arbitrary text

从以下版本开始：

一点三

另请参见：

AudioInputStream

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AudioFileFormat.Type 该 Type类的实例表示一个音频文件的标准类型。

构造方法摘要

构造方法

Modifier	Constructor and Description
	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) 构建一个音频文件格式对象。

方法摘要

Modifier and Type	Method and Description
int	getByteLength() 获取整个音频文件的字节数（不只是它的音频数据）。
AudioFormat	getFormat() 获取音频文件中包含的音频数据的格式。
int	getFrameLength() 获取包含在文件中的音频数据的长度，在示例帧中表示。
Object	getProperty(String key) 获取由键指定的属性值。
AudioFileFormat.Type	getType() 得到的音频文件类型，如 WAVE或 AU。
Map<String,Object>	properties() 获取一个属性不可修改的Map。
String	toString() 提供文件格式的字符串表示形式。

Methods inherited from class java.lang.Object

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

Constructor Detail

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>对象属性

从以下版本开始：

一点五

方法详细信息

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。属性的概念是在 class description进一步解释。

结果

包含所有的属性 Map<String,Object>对象。如果没有确认属性，则返回一个空的Map。

从以下版本开始：

一点五

另请参见：

getProperty(String)

getProperty

public Object getProperty(String key)

获取由键指定的属性值。属性的概念是在 class description进一步解释。

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

参数

key -预期性能的关键

结果

该物业具有指定键的值，或 null如果属性不存在。

从以下版本开始：

一点五

另请参见：

properties()

toString

public String toString()

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

重写：

toString 方法重写，继承类 Object

结果

作为字符串的文件格式