HTMLMediaElement: autoplay-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die HTMLMediaElement.autoplay
-Eigenschaft spiegelt das autoplay
HTML-Attribut wider und gibt an, ob die Wiedergabe automatisch beginnen soll, sobald genügend Medieninhalte verfügbar sind, um ununterbrochen abzuspielen.
Ein Medienelement, dessen Quelle ein MediaStream
ist und dessen autoplay
-Eigenschaft true
ist, beginnt mit der Wiedergabe, wenn es aktiv wird (das heißt, wenn MediaStream.active
true
wird).
Hinweis: Websites, die automatisch Audio (oder Videos mit einer Tonspur) abspielen, können für Benutzer ein unangenehmes Erlebnis darstellen. Daher sollte dies möglichst vermieden werden. Wenn Sie die Autoplay-Funktionalität anbieten müssen, sollten Sie diese optional gestalten (erfordern, dass ein Benutzer sie speziell aktiviert). Autoplay kann jedoch nützlich sein, wenn Medienelemente erstellt werden, deren Quelle zu einem späteren Zeitpunkt, unter Benutzerkontrolle, festgelegt wird.
Für einen viel ausführlicheren Blick auf Autoplay, das Blockieren von Autoplay und darauf, wie man reagiert, wenn Autoplay durch den Browser des Benutzers blockiert wird, lesen Sie unseren Artikel Autoplay-Leitfaden für Media- und Web Audio APIs.
Wert
Ein boolean-Wert, der true
ist, wenn das Medienelement die Wiedergabe beginnt, sobald genügend Inhalte geladen wurden, um dies ohne Unterbrechung zu ermöglichen.
Hinweis:
Einige Browser bieten Benutzern die Möglichkeit, autoplay
zu überschreiben, um zu verhindern, dass störende Audio- oder Videoinhalte ohne Erlaubnis oder im Hintergrund abgespielt werden. Verlassen Sie sich nicht darauf, dass autoplay
tatsächlich die Wiedergabe startet, sondern verwenden Sie stattdessen das play
-Ereignis.
Beispiele
<video id="video" controls>
<source
src="https://player.vimeo.com/external/250688977.sd.mp4?s=d14b1f1a971dde13c79d6e436b88a6a928dfe26b&profile_id=165" />
</video>
// Disable autoplay (recommended)
// false is the default value
document.querySelector("#video").autoplay = false;
Spezifikationen
Specification |
---|
HTML # dom-media-autoplay |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
autoplay |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
Siehe auch
HTMLMediaElement
: Schnittstelle, die verwendet wird, um dieHTMLMediaElement.autoplay
-Eigenschaft zu definieren<audio>
,<video>