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

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;

Spezifikationen

Specification
HTML
# dom-media-autoplay

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
autoplay

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch