HTMLAudioElement - 提供对 <audio> 元素的访问和操作

HTMLAudioElement 接口提供对 <audio> 元素属性的访问，以及操作它们的方法。它派生自 HTMLMediaElement 接口。

属性

没有特有的属性; 继承其父级 HTMLMediaElement 和 HTMLElement 的属性。

方法

从其父类 HTMLMediaElement 和HTMLElement 继承了方法。

构造函数

语法

mySound = new Audio([URLString]);

描述

音频元素的构造函数。返回对象的 preload 属性设置为 auto，src 属性设置为参数值。浏览器在返回对象之前开始异步处理资源。

注意：只要正在播放，就不会对使用 new Audio() 构造的 Audio 元素进行垃圾回收。它将继续播放并可被听到，直到调用 pause() 或播放结束。

参数

URLString (预期类型：DOMString；可选)

构造的 HTMLAudioElement 的 src 属性。

常规方法

名称 & 参数	返回值	描述
mozCurrentSampleOffset()	unsigned long long	指示通过调用 mozWriteAudio() 创建的音频流的当前偏移量。该偏移量指定为自流开始以来的样本数。
mozSetup(in PRUint32 channels, in PRUint32 rate)	void	设置用于写入的音频流。您可以指定通道数（单声道为 1 或立体声为 2），然后是采样率（例如，44.1kHz 为 44100）。
mozWriteAudio(in jsval data)	unsigned long	将音频写入当前偏移量的流中。返回实际写入流的字节数。

实例

基本用法

您可以完全使用 JavaScript 来创建 HTMLAudioElement ：

var horn = new Audio('car_horn.wav');
horn.play();

音频元素的一些常用属性包括 src，currentTime，duration，paused，muted 和 volume。该代码段将音频文件的持续时间复制到变量：

var horn = new Audio('car_horn.wav');
horn.addEventListener('loadeddata', () => {
  let duration = horn.duration;
  // duration 变量现在保存音频剪辑的持续时间（以秒为单位）
})

规范

规范	状态	备注
HTML Living Standard HTMLAudioElement 的定义	现行的标准	-
HTML5 HTMLAudioElement 的定义	推荐	-

桌面浏览器兼容性

移动浏览器兼容性

相关链接

• 实现该接口的 HTML 元素：<audio>。