Module java.desktop

软件包 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 Description "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

从以下版本开始：

1.3

另请参见：

AudioInputStream

Nested Class Summary

Nested Classes

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

构造方法摘要

构造方法

Modifier	Constructor	描述
protected	AudioFileFormat(AudioFileFormat.Type type, int byteLength, AudioFormat format, int frameLength)	构造音频文件格式对象。
	AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength)	构造音频文件格式对象。
	AudioFileFormat(AudioFileFormat.Type type, AudioFormat format, int frameLength, Map<String,Object> properties)	使用一组定义的属性构建音频文件格式对象。

方法摘要

Modifier and Type	方法	描述
int	getByteLength()	获取整个音频文件（不仅仅是其音频数据）的字节大小。
AudioFormat	getFormat()	获取包含在音频文件中的音频数据的格式。
int	getFrameLength()	获取包含在文件中的音频数据的长度，以样本帧表示。
Object	getProperty(String key)	获取由密钥指定的属性值。
AudioFileFormat.Type	getType()	获取音频文件类型，如 WAVE或 AU 。
Map<String,Object>	properties()	获取不可修改的属性地图。
String	toString()	提供文件格式的字符串表示形式。

Methods inherited from class 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()

获取不可修改的属性地图。 属性的概念在class description中进一步解释。

结果

一个包含所有属性的Map<String, Object>对象。 如果没有属性被识别，则返回空的地图。

从以下版本开始：

1.5

另请参见：

getProperty(String)

getProperty

public Object getProperty(String key)

获取由密钥指定的属性值。 在class description中进一步解释了属性的概念。

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

参数

key - 所需属性的关键

结果

具有指定键的属性的值，如果属性不存在， null

从以下版本开始：

1.5

另请参见：

properties()

toString

public String toString()

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

重写：

toString在 Object

结果

文件格式为字符串