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

Audio()

· 52CE 我爱测

`Audio()`** 构造器创建并返回一个 HTMLAudioElement,可以将它附加到文档中以供用户交互,也可以用于管理和播放背景音乐。

HTML DOM

Audio() 构造器创建并返回一个 HTMLAudioElement,可以将它附加到文档中以供用户交互,也可以用于管理和播放背景音乐。

语法

audioObj = new Audio(url);

参数

  • url
    • : 一个可选的、包含音频文件 URL 的 String。

返回值

新创建的 HTMLAudioElement 对象,被设置为播放指定 url的音频文件。新对象的 HTMLMediaElement.preload 属性被设置为 auto 且它的 src 属性被设置为具体的 URL 或 null (当没有提供 URL 时)。如果提供了 URL,浏览器在返回新对象之前开始异步加载媒体资源。

使用说明

你也可以使用其他元素创建方法,例如 document 对象的 Document.createElement 方法,去构建一个新的 HTMLAudioElement.

检测回放时机

提供三种方法给开发者,判断音频文件是否已经加载,允许开始回放:

  • 检测 HTMLMediaElement.readyState 属性的值。如果值是 HTMLMediaElement.HAVE_FUTURE_DATA,说明有足够的数据开始回放并能至少播放一小段时间。如果值是 HTMLMediaElement.HAVE_ENOUGH_DATA,根据当前的下载速率,说明有足够的数据,你可以无干扰地播放至结束。
  • 监听 HTMLMediaElement.canplay_event 事件。当足够的音频数据被发送至 <audio> 元素,能开始回放,即使可能出现中断时,会触发该事件。
  • 监听 HTMLMediaElement.canplaythrough_event 事件。当音频应该没有干扰能够顺利播放时将会触发该事件。

基于事件的方法是最优的:

myAudioElement.addEventListener("canplaythrough", (event) => {
  /* 音频可以播放;如果权限允许则播放 */
  myAudioElement.play();
});

内存使用与管理

如果所有使用 Audio() 构造函数创建的 audio 元素被删除,根据 JavaScript 垃圾回收机制,如果播放正在进行,内存中的 audio 元素不会被移除。相反,音频将会继续播放并且它的对象会保留在内存中,直到播放结束或是被暂停(例如调用 HTMLMediaElement.pause)。在那个时候,这个对象才会成为垃圾回收的目标。

规范

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

参见

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

资料来源与适用范围

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

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

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