模块  java.desktop
软件包  javax.sound.sampled

Class 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

    • 构造方法详细信息

      • 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

    • 方法详细信息

      • 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
        结果
        文件格式为字符串