Audio() | Web API

在此页

句法
用法注意事项
规范
浏览器兼容性
另请参阅
相关话题

Audio() constructor creates and returns a new HTMLAudioElement which can be either attached to a document for the user to interact with and/or listen to, or can be used offscreen to manage and play audio.

句法

audioObj = new Audio(url);

参数

url 可选: An optional DOMString containing the URL of an audio file to be associated with the new audio element.

返回值

新的 HTMLAudioElement object, configured to be used for playing back the audio from the file specified by url .The new object's preload property is set to auto 及其 src property is set to the specified URL or null if no URL is given. If a URL is specified, the browser begins to asynchronously load the media resource before returning the new object.

用法注意事项

You can also use other element-creation methods, such as the document 对象的 createElement() method, to construct a new HTMLAudioElement .

Determining when playback can begin

There are three ways you can tell when enough of the audio file has loaded to allow playback to begin:

Check the value of the readyState property. If it's HTMLMediaElement.HAVE_FUTURE_DATA , there's enough data available to begin playback and play for at least a short time. If it's HTMLMediaElement.HAVE_ENOUGH_DATA , then there's enough data available that, given the current download rate, you should be able to play the audio through to the end without interruption.
Listen for the canplay event. It is sent to the <audio> element when there's enough audio available to begin playback, although interruptions may occur).
Listen for the canplaythrough event. It is sent when it's estimated that the audio should be able to play to the end without interruption.

The event-based approach is best:

myAudioElement.addEventListener("canplaythrough", event => {
  /* the audio is now playable; play it if permissions allow */
  myAudioElement.play();
});

Memory usage and management

If all references to an audio element created using the Audio() constructor are deleted, the element itself won't be removed from memory by the JavaScript runtime's garbage collection mechanism if playback is currently underway. Instead, the audio will keep playing and the object will remain in memory until playback ends or is paused (such as by calling pause() ). At that time, the object becomes subject to garbage collection.

规范

规范	状态	注释
HTML 实时标准 The definition of 'Audio()' 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
`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

图例

完整支持

另请参阅

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

元数据

最后修改： Feb 11, 2020

在此页

句法

参数

返回值

用法注意事项

Determining when playback can begin

Memory usage and management

规范

浏览器兼容性

图例

另请参阅

相关话题