模块 java.desktop
包 javax.sound.sampled

类 AudioFileFormat

java.lang.Object
javax.sound.sampled.AudioFileFormat
public class AudioFileFormat extends Object
AudioFileFormat 类的实例描述了一个音频文件，包括文件类型、文件的字节长度、文件中包含的音频数据的样本帧长度以及音频数据的格式。

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

AudioFileFormat 对象可以包含一组属性。属性是一对键和值：键是 String 类型，关联的属性值是任意对象。属性指定附加信息元数据（如作者、版权或文件持续时间）。属性是可选信息，文件读取器和文件写入器实现不需要提供或识别属性。

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

音频文件格式属性
属性键 值类型 Description
“期间” Long 文件的播放持续时间（以微秒为单位）
“作者” String 此文件的作者姓名
“标题” String 这个文件的标题
“版权” String 版权留言
“日期” Date 录制或发布日期
“评论” String 任意文本
自从：
1.3
参见：

  • 构造方法详细信息

    • AudioFileFormat

      protected AudioFileFormat(AudioFileFormat.Type  type, int byteLength, AudioFormat  format, int frameLength)
      构造音频文件格式对象。此受保护的构造方法旨在供文件读取服务的提供者在返回有关音频文件或有关受支持的音频文件格式的信息时使用。
      参数：
      type - 音频文件的类型
      byteLength - 文件的字节长度，或 AudioSystem.NOT_SPECIFIED
      format - 文件中包含的音频数据的格式
      frameLength - 样本帧中的音频数据长度，或 AudioSystem.NOT_SPECIFIED
      参见：

    • 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 。
      返回：
      音频文件类型
      参见：

    • getByteLength

      public int getByteLength()
      获取整个音频文件（不仅仅是其音频数据）的字节大小。
      返回：
      以字节为单位的音频文件长度
      参见：

    • getFormat

      public AudioFormat  getFormat()
      获取音频文件中包含的音频数据的格式。
      返回：
      音频数据格式

    • getFrameLength

      public int getFrameLength()
      获取文件中包含的音频数据的长度，以样本帧表示。
      返回：
      文件中音频数据的采样帧数
      参见：

    • properties

      public Map <String ,Object > properties()
      获取不可修改的属性映射。 class description 中进一步解释了属性的概念。
      返回：
      包含所有属性的 Map<String, Object> 对象。如果未识别出任何属性，则返回一个空map。
      自从：
      1.5
      参见：

    • getProperty

      public Object  getProperty(String  key)
      获取键指定的属性值。 class description 中进一步解释了属性的概念。

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

      参数：
      key - 所需属性的键
      返回：
      具有指定键的属性的值，如果属性不存在则返回 null
      自从：
      1.5
      参见：

    • toString

      public String  toString()
      返回音频文件格式的字符串表示形式。
      重写：
      toString 在类 Object 中
      返回：
      音频文件格式的字符串表示