Module java.desktop
Package javax.sound.sampled

Class AudioFileFormat

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

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

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

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

音频文件格式属性
属性键 值类型 描述
"duration" Long 文件的播放持续时间（以微秒为单位）
"author" String 此文件的作者名称
"title" String 此文件的标题
"copyright" String 版权信息
"date" Date 录制或发布日期
"comment" String 任意文本
自版本:
1.3
参见:

  • Constructor Details

    • 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

  • Method Details

    • 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()
      获取属性的不可修改映射。有关属性的概念在类描述中进一步解释。
      返回:
      包含所有属性的Map<String, Object>对象。如果未识别任何属性，则返回空映射。
      自版本:
      1.5
      参见:

    • getProperty

      public Object getProperty(String key)
      获取由键指定的属性值。有关属性的概念在类描述中进一步解释。

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

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

    • toString

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