HTMLAudioElement

在此页

构造函数
特性
方法
范例
事件
规范
浏览器兼容性
另请参阅
相关话题

HTMLAudioElement interface provides access to the properties of <audio> elements, as well as methods to manipulate them. It's based on, and inherits properties and methods from, the HTMLMediaElement 接口。

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="../API/HTMLMediaElement" target="_top"><rect x="331" y="65" width="160" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="411" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLMediaElement</text></a><polyline points="331,89  321,84  321,94  331,89" stroke="#D4DDE4" fill="none"/><line x1="321" y1="89" x2="291" y2="89" stroke="#D4DDE4"/><a xlink:href="../API/HTMLAudioElement" target="_top"><rect x="131" y="65" width="160" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="211" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLAudioElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

构造函数

Audio(): 创建并返回新 HTMLAudioElement object, optionally starting the process of loading an audio file into it if the file URL is given.

特性

No specific properties; inherits properties from its parent, HTMLMediaElement , and from HTMLElement .

方法

继承方法来自其父级 HTMLMediaElement , and from HTMLElement . It offers no methods of its own.

Obsolete Mozilla-only methods

The following methods are non-standard and should not be used.

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 mozWriteAudio() .
mozSetup()
mozWriteAudio()

范例

基本用法

You can create a HTMLAudioElement entirely with JavaScript using the Audio() 构造函数：

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

then you can invoke the play() method on the element

audioElement.play();

A common gotcha is trying to play an audio element immediately on page load. Modern browser's default autoplay policy will block that from happening. Refer to firefox and chrome for best practices and work arounds.

Some of the more commonly used properties of the audio element include src , currentTime , duration , paused , muted ，和 volume . This snippet copies the audio file's duration to a variable:

var audioElement = new Audio('car_horn.wav');
audioElement.addEventListener('loadeddata', () => {
  let duration = audioElement.duration;
  // The duration variable now holds the duration (in seconds) of the audio clip
})

事件

继承方法来自其父级 HTMLMediaElement , and from its ancestor HTMLElement . Listen to events using addEventListener() 或通过把事件监听器赋值给 on eventname 特性为此接口。

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLAudioElement' in that specification.	实时标准
HTML5 The definition of 'HTMLAudioElement' in that specification.	推荐

浏览器兼容性

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. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLAudioElement`	Chrome 1	Edge 12	Firefox 3.5	IE 9	Opera 10.5	Safari 3.1	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 11	Safari iOS 2	Samsung Internet Android 1.0
`Audio()` 构造函数	Chrome Yes	Edge 12	Firefox 3.5	IE 10	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`mozCurrentSampleOffset()` 弃用非标	Chrome No	Edge No	Firefox 4 — 31	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android ? — 31	Opera Android No	Safari iOS No	Samsung Internet Android No
`mozSetup()` 弃用非标	Chrome No	Edge No	Firefox 4 — 31	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android ? — 31	Opera Android No	Safari iOS No	Samsung Internet Android No
`mozWriteAudio()` 弃用非标	Chrome No	Edge No	Firefox 4	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android Yes	Opera Android No	Safari iOS No	Samsung Internet Android No

图例

完整支持
不支持
非标。预期跨浏览器支持较差。
弃用。不要用于新网站。

另请参阅

Web media technologies
Using audio and video in HTML
实现此接口的 HTML 元素： <audio> .

元数据

最后修改： Oct 23, 2019

在此页

构造函数

特性

方法

Obsolete Mozilla-only methods

范例

基本用法

事件

规范

浏览器兼容性

图例

另请参阅

相关话题