HTMLMediaElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

* Some parts of this feature may have varying levels of support.

DasHTMLMediaElement Interface erweitert dasHTMLElement um die Eigenschaften und Methoden, die erforderlich sind, um grundlegende medienbezogene Fähigkeiten zu unterstützen, die für Audio und Video gemeinsam sind.

Die ElementeHTMLVideoElement undHTMLAudioElement erben beide dieses Interface.

Instanzeigenschaften

Dieses Interface erbt auch Eigenschaften von seinen VorfahrenHTMLElement,Element,Node undEventTarget.

HTMLMediaElement.audioTracksSchreibgeschützt: EinAudioTrackList Objekt, das dieAudioTrack Objekte im Element auflistet.
HTMLMediaElement.autoplay: Ein boolescher Wert, der das HTML-Attributautoplay widerspiegelt und angibt, ob die Wiedergabe automatisch beginnen soll, sobald genügend Medien verfügbar sind, um dies ohne Unterbrechung zu tun.
Hinweis:Das automatische Abspielen von Audio, wenn der Nutzer es nicht erwartet oder wünscht, ist eine schlechte Benutzererfahrung und sollte in den meisten Fällen vermieden werden, obwohl es Ausnahmen gibt. Weitere Informationen finden Sie imLeitfaden zur automatischen Wiedergabe von Medien und Web Audio APIs. Beachten Sie, dass Browser Autoplay-Anfragen ignorieren können, sodass Sie sicherstellen sollten, dass Ihr Code nicht darauf angewiesen ist, dass Autoplay funktioniert.
HTMLMediaElement.bufferedSchreibgeschützt: Gibt einTimeRanges Objekt zurück, das die Bereiche der Medienquelle angibt, die der Browser gepuffert hat (falls vorhanden), wenn auf diebuffered Eigenschaft zugegriffen wird.
HTMLMediaElement.controls: Ein Boolean, der das HTML-Attributcontrols widerspiegelt und angibt, ob Benutzeroberflächenelemente zur Steuerung der Ressource angezeigt werden sollen.
HTMLMediaElement.controlsList: Gibt eineDOMTokenList zurück, die dem User-Agent hilft, auszuwählen, welche Steuerungselemente auf dem Medienelement angezeigt werden sollen, wann immer der User-Agent sein eigenes Set von Steuerungen anzeigt. DieDOMTokenList kann einen oder mehrere der drei möglichen Werte haben:nodownload,nofullscreen, undnoremoteplayback.
HTMLMediaElement.crossOrigin: Ein String, der dieCORS-Einstellung für dieses Medienelement angibt.
HTMLMediaElement.currentSrcSchreibgeschützt: Gibt einen String mit der absoluten URL der gewählten Medienressource zurück.
HTMLMediaElement.currentTime: Ein doppelt präziser Fließkommertyp, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium nicht zu spielen begonnen hat und nicht gesucht wurde, ist dieser Wert die anfängliche Wiedergabezeit des Mediums. Wenn Sie diesen Wert festlegen, sucht das Medium zur neuen Zeit. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.
HTMLMediaElement.defaultMuted: Ein Boolean, der das HTML-Attributmuted widerspiegelt und angibt, ob die Audioausgabe des Medienelements standardmäßig stummgeschaltet sein soll.
HTMLMediaElement.defaultPlaybackRate: Eindouble, der die Standard-Wiedergabegeschwindigkeit für das Medium angibt.
HTMLMediaElement.disableRemotePlayback: Ein Boolean, der den Zustand der Remote-Wiedergabe festlegt oder zurückgibt, was angibt, ob das Medienelement eine Benutzeroberfläche für die Remote-Wiedergabe besitzen darf.
HTMLMediaElement.durationSchreibgeschützt: Ein schreibgeschützter, doppelt präziser Fließkommawert, der die Gesamtdauer des Mediums in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, ist der zurückgegebene WertNaN. Wenn das Medium von unbestimmter Länge ist (wie gestreamtes Live-Medium, eine WebRTC-Call-Medienquelle oder ähnliches), ist der WertInfinity.
HTMLMediaElement.endedSchreibgeschützt: Gibt einen Boolean zurück, der angibt, ob das Medienelement mit der Wiedergabe fertig ist.
HTMLMediaElement.errorSchreibgeschützt: Gibt einMediaError Objekt für den letzten Fehler zurück, odernull, wenn kein Fehler vorlag.
HTMLMediaElement.loop: Ein Boolean, der das HTML-Attributloop widerspiegelt, was angibt, ob das Medienelement neu starten soll, wenn es das Ende erreicht.
HTMLMediaElement.mediaKeysSchreibgeschütztSicherer Kontext: Gibt einMediaKeys Objekt zurück, das einen Satz von Schlüsseln ist, den das Element zur Entschlüsselung von Mediendaten während der Wiedergabe verwenden kann. Wenn kein Schlüssel verfügbar ist, kann esnull sein.
HTMLMediaElement.muted: Ein Boolean, der bestimmt, ob der Ton stummgeschaltet ist.true wenn der Ton stumm ist, undfalse andernfalls.
HTMLMediaElement.networkStateSchreibgeschützt: Gibt einenunsigned short (Enumeration) zurück, der den aktuellen Zustand des Abrufens der Medien über das Netzwerk angibt.
HTMLMediaElement.pausedSchreibgeschützt: Gibt einen Boolean zurück, der angibt, ob das Medienelement pausiert ist.
HTMLMediaElement.playbackRate: Eindouble, das die Geschwindigkeit angibt, mit der das Medium wiedergegeben wird.
HTMLMediaElement.playedSchreibgeschützt: Gibt einTimeRanges Objekt zurück, das die Bereiche der Medienquelle enthält, die der Browser abgespielt hat, falls vorhanden.
HTMLMediaElement.preload: Ein String, der das HTML-Attributpreload widerspiegelt und angibt, welche Daten vorab geladen werden sollen, falls vorhanden. Mögliche Werte sind:none,metadata,auto.
HTMLMediaElement.preservesPitch: Ein boolescher Wert, der bestimmt, ob die Tonhöhe erhalten bleibt. Wennfalse gesetzt ist, wird die Tonhöhe an die Geschwindigkeit des Audios angepasst.
HTMLMediaElement.readyStateSchreibgeschützt: Gibt einenunsigned short (Enumeration) zurück, der den Bereitschaftszustand des Mediums angibt.
HTMLMediaElement.remoteSchreibgeschützt: Gibt einRemotePlayback Objektinstanz zurück, die mit dem Medienelement verbunden ist.
HTMLMediaElement.seekableSchreibgeschützt: Gibt einTimeRanges Objekt zurück, das die Zeitbereiche enthält, zu denen der Benutzer springen kann, falls vorhanden.
HTMLMediaElement.seekingSchreibgeschützt: Gibt einen Boolean zurück, der angibt, ob das Medium gerade dabei ist, zu einer neuen Position zu springen.
HTMLMediaElement.sinkIdSchreibgeschütztSicherer Kontext: Gibt einen String zurück, der die eindeutige ID des Audiogeräts zur Ausgabe angibt, oder einen leeren String, wenn das Standard-Audiogerät des User-Agent verwendet wird.
HTMLMediaElement.src: Ein String, der das HTML-Attributsrc widerspiegelt und die URL einer Medienressource angibt, die verwendet werden soll.
HTMLMediaElement.srcObject: Ein Objekt, das als Quelle des mit demHTMLMediaElement verbundenen Mediums dient, odernull, wenn nicht zugewiesen.
HTMLMediaElement.textTracksSchreibgeschützt: Gibt einTextTrackList Objekt zurück, das die Liste derTextTrack Objekte im Element enthält.
HTMLMediaElement.videoTracksSchreibgeschützt: Gibt einVideoTrackList Objekt zurück, das die Liste derVideoTrack Objekte im Element enthält.
HTMLMediaElement.volume: Eindouble, das die Lautstärke von 0.0 (stumm) bis 1.0 (am lautesten) angibt.

Veraltete Eigenschaften

Diese Eigenschaften sind veraltet und sollten nicht verwendet werden, auch wenn ein Browser sie noch unterstützt.

HTMLMediaElement.controllerVeraltet Nicht standardisiert: Ein MediaController Objekt, das den dem Element zugewiesenen Mediencontroller darstellt, odernull, wenn keiner zugeteilt ist.
HTMLMediaElement.mediaGroupVeraltet Nicht standardisiert: Ein String, der das HTML-Attributmediagroup widerspiegelt und den Namen der Gruppe von Elementen angibt, zu der es gehört. Eine Gruppe von Medienelementen teilt sich einen gemeinsamen MediaController.
HTMLMediaElement.mozAudioCapturedSchreibgeschütztNicht standardisiert Veraltet: Gibt einen Boolean zurück. Bezogen auf die Aufzeichnung von Audiostreams.
HTMLMediaElement.mozFragmentEndNicht standardisiert Veraltet: Eindouble, das Zugriff auf die Fragmentendzeit bietet, wenn das Medienelement eine Fragment-URI fürcurrentSrc hat, andernfalls entspricht es der Mediendauer.

Instanzmethoden

Dieses Interface erbt auch Methoden von seinen VorfahrenHTMLElement,Element,Node undEventTarget.

HTMLMediaElement.addTextTrack(): Fügt ein neuesTextTrack Objekt (wie z. B. eine Spur für Untertitel) zu einem Medienelement hinzu. Dies ist eine programmatische Schnittstelle und wirkt sich nicht auf das DOM aus.
HTMLMediaElement.captureStream(): GibtMediaStream zurück, erfasst einen Stream des Medieninhalts.
HTMLMediaElement.canPlayType(): Bei Angabe eines Strings, der einen MIME-Medientyp angibt (möglicherweise mit demcodecs Parameter enthalten), gibtcanPlayType() den Stringprobably zurück, wenn das Medium abspielbar sein sollte,maybe, wenn nicht genug Informationen vorhanden sind, um festzustellen, ob das Medium abgespielt wird oder nicht, oder einen leeren String, wenn das Medium nicht abgespielt werden kann.
HTMLMediaElement.fastSeek(): Schnelles Springen zur angegebenen Zeit mit geringer Präzision.
HTMLMediaElement.load(): Setzt das Medium auf den Anfang zurück und wählt die beste verfügbare Quelle aus den angegebenen Quellen aus, die mit demsrc Attribut oder dem<source> Element bereitgestellt wurden.
HTMLMediaElement.pause(): Pausiert die Medienwiedergabe.
HTMLMediaElement.play(): Beginnt die Wiedergabe des Mediums.
HTMLMediaElement.seekToNextFrame()Veraltet Nicht standardisiert: Springt zum nächsten Frame im Medium. Diese nicht standardisierte, experimentelle Methode macht es möglich, das Lesen und Rendern von Medien manuell mit einer benutzerdefinierten Geschwindigkeit zu steuern oder durch das Medium Frame für Frame zu gehen, um Filterung oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys()Sicherer Kontext: GibtPromise zurück. Setzt dieMediaKeys Schlüssel, die zur Entschlüsselung von Medien während der Wiedergabe verwendet werden.
HTMLMediaElement.setSinkId()Sicherer Kontext: Setzt die ID des Audiogeräts zur Ausgabe und gibt einPromise zurück. Dies funktioniert nur, wenn die Anwendung berechtigt ist, das angegebene Gerät zu verwenden.

Veraltete Methoden

Diese Methoden sind veraltet und sollten nicht verwendet werden, auch wenn ein Browser sie noch unterstützt.

HTMLMediaElement.mozCaptureStream()Nicht standardisiert: Die Firefox-präfixierte Entsprechung von HTMLMediaElement.captureStream(). Weitere Details finden Sie in derBrowser-Kompatibilität.
HTMLMediaElement.mozCaptureStreamUntilEnded()Nicht standardisiert Veraltet: [Beschreibung einfügen]
HTMLMediaElement.mozGetMetadata()Nicht standardisiert Veraltet: Gibt ein Object zurück, das Eigenschaften enthält, die Metadaten aus der spielenden Medienressource als{key: value} Paare repräsentieren. Eine separate Kopie der Daten wird jedes Mal zurückgegeben, wenn die Methode aufgerufen wird. Diese Methode muss nach demloadedmetadata Ereignisaufruf aufgerufen werden.

Ereignisse

Erbt Ereignisse von seinem Elternteil,HTMLElement.

Hören Sie diese Ereignisse mitaddEventListener() oder durch Zuweisen eines Ereignislisteners zuroneventname Eigenschaft dieses Interfaces.

abort: Wird ausgelöst, wenn die Ressource nicht vollständig geladen wurde, jedoch nicht infolge eines Fehlers.
canplay: Wird ausgelöst, wenn der User-Agent das Medium abspielen kann, jedoch schätzt, dassnicht genug Daten geladen wurden, um das Medium bis zu seinem Ende abzuspielen, ohne anhalten zu müssen, um mehr Inhalte zwischenzupuffern.
canplaythrough: Wird ausgelöst, wenn der User-Agent das Medium abspielen kann und schätzt, dass genug Daten geladen wurden, um das Medium bis zu seinem Ende abzuspielen, ohne anhalten zu müssen, um mehr Inhalte zu puffern.
durationchange: Wird ausgelöst, wenn die Duration-Eigenschaft aktualisiert wurde.
emptied: Wird ausgelöst, wenn das Medium leer geworden ist; zum Beispiel, wenn das Medium bereits geladen (oder teilweise geladen) wurde, und dieHTMLMediaElement.load() Methode aufgerufen wird, um es neu zu laden.
encrypted: Wird ausgelöst, wenn Initialisierungsdaten im Medium gefunden werden, die anzeigen, dass das Medium verschlüsselt ist.
ended: Wird ausgelöst, wenn die Wiedergabe gestoppt wird, weil das Ende des Mediums (<audio> oder<video>) erreicht ist oder weil keine weiteren Daten verfügbar sind.
error: Wird ausgelöst, wenn die Ressource aufgrund eines Fehlers nicht geladen werden konnte.
loadeddata: Wird ausgelöst, wenn der erste Frame des Mediums fertig geladen ist.
loadedmetadata: Wird ausgelöst, wenn die Metadaten geladen wurden.
loadstart: Wird ausgelöst, wenn der Browser begonnen hat, eine Ressource zu laden.
pause: Wird ausgelöst, wenn eine Anforderung, die Wiedergabe zu pausieren, bearbeitet wird, und die Aktivität in den pausierten Zustand übergegangen ist. Dies tritt am häufigsten auf, wenn dieHTMLMediaElement.pause() Methode des Mediums aufgerufen wird.
play: Wird ausgelöst, wenn diepaused-Eigenschaft vontrue auffalse geändert wird, als Ergebnis derHTMLMediaElement.play() Methode oder desautoplay Attributs.
playing: Wird ausgelöst, wenn die Wiedergabe nach einer Pause oder einer Verzögerung aufgrund fehlender Daten bereit zum Start ist.
progress: Wird periodisch ausgelöst, während der Browser eine Ressource lädt.
ratechange: Wird ausgelöst, wenn die Wiedergaberate geändert wurde.
seeked: Wird ausgelöst, wenn ein Suchvorgang abgeschlossen ist.
seeking: Wird ausgelöst, wenn ein Suchvorgang beginnt.
stalled: Wird ausgelöst, wenn der User-Agent versucht, Mediendaten abzurufen, die Daten aber unerwartet nicht bereitgestellt werden.
suspend: Wird ausgelöst, wenn das Laden von Mediendaten angehalten wurde.
timeupdate: Wird ausgelöst, wenn die Zeit, die durch diecurrentTime Eigenschaft angegeben wird, aktualisiert wurde.
volumechange: Wird ausgelöst, wenn die Lautstärke geändert wurde.
waiting: Wird ausgelöst, wenn die Wiedergabe wegen eines vorübergehenden Mangels an Daten angehalten ist.
waitingforkey: Wird ausgelöst, wenn die Wiedergabe beim Warten auf einen Schlüssel erstmals blockiert wird.