HTMLMediaElement: autoplay 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTMLMediaElement.autoplay 属性反映了 autoplay HTML 属性,表示是否应在有足够媒体可用且不中断的情况下自动开始播放。

源为 MediaStreamautoplay 属性为 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

浏览器兼容性

另见