JavaTM Platform
Standard Ed. 6

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()
          获得音频文件类型,如 WAVEAU
 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()
获得音频文件类型,如 WAVEAU

返回:
音频文件类型
另请参见:
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
返回:
以字符串表示的文件格式

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策