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

瀏覽器相容性

另見