HTMLMediaElement: autoplay 属性
HTMLMediaElement.autoplay 属性反映了 autoplay HTML 属性,表示是否应在有足够媒体可用且不中断的情况下自动开始播放。
源为 MediaStream 且 autoplay 属性为 true 的媒体元素将在其变得活跃时开始播放(即,当 MediaStream.active 变为 true 时)。
注意: 自动播放音频(或带音频轨的视频)的网站可能会给用户带来不愉快的体验,因此应尽量避免。如果必须提供自动播放功能,则应使其成为可选功能(需要用户明确启用)。但是,在创建稍后会在用户控制下设置源的媒体元素时,自动播放可能很有用。
要更深入地了解自动播放、自动播放阻止以及如何应对用户浏览器阻止自动播放的情况,请参阅我们的文章 媒体和 Web Audio API 的自动播放指南。
值
一个布尔值,如果媒体元素加载了足够的内容以便不中断地开始播放,则为 true。
注意: 某些浏览器允许用户覆盖 autoplay 设置,以防止未经许可在后台播放具有侵扰性的音频或视频。不要依赖 autoplay 来实际开始播放,而应使用 play 事件。
示例
html
<video id="video" controls>
<source
src="https://player.vimeo.com/external/250688977.sd.mp4?s=d14b1f1a971dde13c79d6e436b88a6a928dfe26b&profile_id=165" />
</video>
js
// Disable autoplay (recommended)
// false is the default value
document.querySelector("#video").autoplay = false;
规范
| 规范 |
|---|
| HTML # dom-media-autoplay |
浏览器兼容性
加载中…
另见
HTMLMediaElement:用于定义HTMLMediaElement.autoplay属性的接口<audio>,<video>