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>