模块 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

嵌套类汇总

嵌套类

变量和类型	类	描述
static class	AudioFileFormat.Type	Type类的实例表示标准类型的音频文件之一。

构造方法摘要

构造方法

变量	构造器	描述
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)	使用一组已定义的属性构造音频文件格式对象。

方法摘要

变量和类型	方法	描述
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()

获取不可修改的属性映射。 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

结果

文件格式为字符串