Module  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​()
        提供文件格式的字符串表示形式。
        重写:
        toStringObject
        结果
        文件格式为字符串