HTMLMediaElement：autoplay 属性

基线 广泛可用

此功能已完善，可在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用： 2015 年 7 月.

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅