大网数据广告活动
Web 标准与前端开发

HTMLAudioElement

· 52CE 我爱测

`HTMLAudioElement`** 接口提供对 audio 元素的属性访问及一系列操控它的方法,它基于并从 HTMLMediaElement 接口继承属性和方法。

HTML DOM

HTMLAudioElement 接口提供对 audio 元素的属性访问及一系列操控它的方法,它基于并从 HTMLMediaElement 接口继承属性和方法。

构造函数

  • HTMLAudioElement.Audio
    • : 创建并返回一个新的 HTMLAudioElement 对象,如果提供音频文件 URL,则开始加载音频文件。

属性

没有具体的属性;从父类 HTMLMediaElement 和 HTMLElement 继承属性。

方法

从父类 HTMLMediaElement 和 HTMLElement 继承方法,自身不提供方法。

废弃的且仅适用于 Mozilla 的方法

以下方法是未标准化的,请勿使用.

  • HTMLAudioElement.mozCurrentSampleOffset
    • : Returns the number of samples form the beginning of the stream that have been written so far into the audio stream created by calling HTMLAudioElement.mozWriteAudio.
  • HTMLAudioElement.mozSetup
    • : Sets up the audio stream to allow writing, given the number of audio channels (1 or 2) and the sample rate in kHz.
  • HTMLAudioElement.mozWriteAudio
    • : Writes a batch of audio frames to the stream at the current offset, returning the number of bytes actually written to the stream.

示例

基本用法

你可以完全使用 JavaScript 的 HTMLAudioElement.Audio 构造函数来创建一个 HTMLAudioElement :

var audioElement = new Audio("car_horn.wav");

然后你可以在这个元素上调用 play() 方法

audioElement.play();

[!NOTE] 一个常见的需求是在页面加载后马上去播放音频,现代浏览器的默认自动播放策略会阻止这一行为,参见 firefox 和 chrome 寻找最佳实践和解决方案。

一些经常被使用的属性,包括 HTMLMediaElement.src、HTMLMediaElement.currentTime、HTMLMediaElement.duration、HTMLMediaElement.paused、HTMLMediaElement.muted 和 HTMLMediaElement.volume。以下这段代码赋值音频文件的播放时长给一个变量:

var audioElement = new Audio("car_horn.wav");
audioElement.addEventListener("loadeddata", () => {
  let duration = audioElement.duration;
  // duration 变量现在存放音频的播放时长(单位秒)
});

事件

从父类 HTMLMediaElement 和祖先 HTMLElement 继承方法。使用 addEventListener() 监听事件或者赋值一个事件监听器给这个接口的 oneventname 属性。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。