HTMLMediaElement

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.

Das HTMLMediaElement-Interface erweitert HTMLElement um die Eigenschaften und Methoden, die benötigt werden, um grundlegende medienbezogene Fähigkeiten zu unterstützen, die für Audio und Video üblich sind.

Die HTMLVideoElement- und HTMLAudioElement-Elemente erben beide von diesem Interface.

EventTarget Node Element HTMLElement HTMLMediaElement

Instanzeigenschaften

Dieses Interface erbt auch Eigenschaften von seinen Vorfahren HTMLElement, Element, Node und EventTarget.

HTMLMediaElement.audioTracks

Eine AudioTrackList, die die AudioTrack-Objekte auflistet, die im Element enthalten sind.

HTMLMediaElement.autoplay

Ein boolescher Wert, der das autoplay-HTML-Attribut 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 Benutzer es nicht erwartet oder wünscht, ist eine schlechte Benutzererfahrung und sollte in den meisten Fällen vermieden werden, obwohl es Ausnahmen gibt. Siehe den Leitfaden zum automatischen Abspielen für Medien und Web-Audio-APIs für mehr Informationen. Beachten Sie, dass Browser Anfragen zum automatischen Abspielen ignorieren können, daher sollte sichergestellt werden, dass Ihr Code nicht davon abhängig ist, dass das automatische Abspielen funktioniert.

HTMLMediaElement.buffered Nur lesbar

Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Mediendatenquelle angibt, die der Browser derzeit gepuffert hat (falls vorhanden), wenn auf die buffered-Eigenschaft zugegriffen wird.

HTMLMediaElement.controls

Ein boolescher Wert, der das controls-HTML-Attribut widerspiegelt und angibt, ob Benutzeroberflächelemente zur Steuerung der Ressource angezeigt werden sollen.

HTMLMediaElement.controlsList Nur lesbar

Gibt eine DOMTokenList zurück, die dem Benutzeragenten hilft, auszuwählen, welche Steuerelemente auf dem Medienelement angezeigt werden sollen, wann immer der Benutzeragent seine eigene Steuerelemente zeigt. Die DOMTokenList nimmt einen oder mehrere der drei möglichen Werte an: nodownload, nofullscreen und noremoteplayback.

HTMLMediaElement.crossOrigin

Ein String, der die CORS-Einstellung für dieses Medienelement angibt.

HTMLMediaElement.currentSrc Nur lesbar

Gibt einen String mit der absoluten URL der gewählten Medienressource zurück.

HTMLMediaElement.currentTime

Ein double-präzisions Gleitkommawert, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium noch nicht zu spielen begonnen hat und nicht gesucht wurde, ist dieser Wert die anfängliche Wiedergabezeit des Mediums. Das Setzen dieses Wertes sucht das Medium zur neuen Zeit. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.

HTMLMediaElement.defaultMuted

Ein boolescher Wert, der das muted-HTML-Attribut widerspiegelt, das angibt, ob die Audioausgabe des Medienelements standardmäßig stummgeschaltet werden soll.

HTMLMediaElement.defaultPlaybackRate

Ein double, das die Standardwiedergabegeschwindigkeit für das Medium angibt.

HTMLMediaElement.disableRemotePlayback

Ein boolescher Wert, der den Status der Remote-Wiedergabe setzt oder zurückgibt, der angibt, ob das Medienelement eine Benutzeroberfläche für die Remote-Wiedergabe haben darf.

HTMLMediaElement.duration Nur lesbar

Ein schreibgeschützter double-präzisions Gleitkommawert, der die Gesamtdauer des Mediums in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, ist der zurückgegebene Wert NaN. Wenn das Medium von unbestimmter Länge ist (wie ein gestreamtes Live-Medium, die Medien eines WebRTC-Anrufs oder ähnliches), ist der Wert +Infinity.

HTMLMediaElement.ended Nur lesbar

Gibt ein boolescher Wert zurück, der angibt, ob das Medienelement das Abspielen beendet hat.

HTMLMediaElement.error Nur lesbar

Gibt ein MediaError-Objekt für den letzten Fehler zurück oder null, wenn kein Fehler aufgetreten ist.

HTMLMediaElement.loop

Ein boolescher Wert, der das loop-HTML-Attribut widerspiegelt, das angibt, ob das Medienelement von vorne beginnen soll, wenn es das Ende erreicht.

HTMLMediaElement.mediaKeys Nur lesbar Secure context

Gibt ein MediaKeys-Objekt zurück, das ein Satz von Schlüsseln ist, die das Element zur Entschlüsselung von Mediendaten während der Wiedergabe verwenden kann. Wenn kein Schlüssel verfügbar ist, kann es null sein.

HTMLMediaElement.muted

Ein boolescher Wert, der bestimmt, ob der Ton stummgeschaltet ist. true, wenn der Ton stumm ist und false andernfalls.

HTMLMediaElement.networkState Nur lesbar

Gibt einen unsigned short (Aufzählung) zurück, der den aktuellen Status des Abspielens des Mediums über das Netzwerk angibt.

HTMLMediaElement.paused Nur lesbar

Gibt ein boolescher Wert zurück, der angibt, ob das Medienelement pausiert ist.

HTMLMediaElement.playbackRate

Ein double, der angibt, mit welcher Rate das Medium abgespielt wird.

HTMLMediaElement.played Nur lesbar

Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Mediendatenquelle enthält, die der Browser gegebenenfalls abgespielt hat.

HTMLMediaElement.preload

Ein String, der das preload-HTML-Attribut 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 beibehalten wird. Wenn auf false gesetzt, passt sich die Tonhöhe an die Geschwindigkeit des Audios an.

HTMLMediaElement.readyState Nur lesbar

Gibt einen unsigned short (Aufzählung) zurück, der den Bereitschaftsstatus des Mediums angibt.

HTMLMediaElement.remote Nur lesbar

Gibt eine RemotePlayback-Objektinstanz zurück, die mit dem Medienelement verbunden ist.

HTMLMediaElement.seekable Nur lesbar

Gibt ein TimeRanges-Objekt zurück, das die Zeitbereiche enthält, zu denen der Benutzer springen kann, falls vorhanden.

HTMLMediaElement.seeking Nur lesbar

Gibt ein boolescher Wert zurück, der angibt, ob das Medium derzeit versucht, eine neue Position zu erreichen.

HTMLMediaElement.sinkId Nur lesbar Secure context

Gibt einen String zurück, der die eindeutige ID des Audiogeräts ist, das die Ausgabe bereitstellt, oder einen leeren String, wenn das vom Benutzeragenten voreingestellte Audiogerät verwendet wird.

HTMLMediaElement.src

Ein String, der das src-HTML-Attribut widerspiegelt und die URL einer zu verwendenden Medienressource enthält.

HTMLMediaElement.srcObject

Ein Objekt, das als Quelle des mit dem HTMLMediaElement verbundenen Mediums dient oder null, wenn nicht zugewiesen.

HTMLMediaElement.textTracks Nur lesbar

Gibt ein TextTrackList-Objekt zurück, das die Liste der im Element enthaltenen TextTrack-Objekte enthält.

HTMLMediaElement.videoTracks Nur lesbar

Gibt ein VideoTrackList-Objekt zurück, das die im Element enthaltene Liste der VideoTrack-Objekte enthält.

HTMLMediaElement.volume

Ein double, das die Lautstärke des Audios angibt, von 0,0 (stumm) bis 1,0 (am lautesten).

Veraltete Eigenschaften

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

HTMLMediaElement.controller Veraltet Nicht standardisiert

Ein MediaController-Objekt, das den dem Element zugewiesenen Mediencontroller darstellt, oder null, wenn keiner zugewiesen ist.

HTMLMediaElement.mediaGroup Veraltet Nicht standardisiert

Ein String, der das mediagroup-HTML-Attribut widerspiegelt, das den Namen der Gruppe von Elementen angibt, zu der es gehört. Eine Gruppe von Medienelementen teilt sich einen gemeinsamen MediaController.

HTMLMediaElement.mozAudioCaptured Nur lesbar Nicht standardisiert Veraltet

Gibt ein boolescher Wert zurück. Bezieht sich auf die Erfassung des Audiostreams.

HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet

Ein double, das Zugriff auf die Fragmentendzeit bietet, wenn das Medienelement eine Fragment-URI für currentSrc hat, andernfalls ist es gleich der Mediedauer.

Instanzmethoden

Dieses Interface erbt auch Methoden von seinen Vorfahren HTMLElement, Element, Node und EventTarget.

HTMLMediaElement.addTextTrack()

Fügt ein neues TextTrack-Objekt (wie ein Track für Untertitel) zu einem Medienelement hinzu. Dies ist nur eine programmatische Schnittstelle und beeinflusst nicht das DOM.

HTMLMediaElement.captureStream()

Gibt MediaStream zurück, erfasst einen Stream des Medieninhalts.

HTMLMediaElement.canPlayType()

Angenommen, ein String, der einen MIME-Mediatype spezifiziert (möglicherweise mit dem codecs-Parameter), gibt canPlayType() den String probably zurück, wenn das Medium abgespielt werden sollte, maybe, wenn es nicht genug Informationen gibt, um zu bestimmen, ob das Medium abgespielt wird oder nicht, oder einen leeren String, wenn das Medium nicht abgespielt werden kann.

HTMLMediaElement.fastSeek()

Sucht schnell 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 durch das src-Attribut oder das <source>-Element bereitgestellten Quellen aus.

HTMLMediaElement.pause()

Pausiert die Medienwiedergabe.

HTMLMediaElement.play()

Beginnt die Wiedergabe des Mediums.

HTMLMediaElement.seekToNextFrame() Veraltet Nicht standardisiert

Sucht zum nächsten Frame im Medium. Diese nicht standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien mit benutzerdefinierter Geschwindigkeit manuell zu steuern oder sich frameweise durch das Medium zu bewegen, um Filterung oder andere Operationen durchzuführen.

HTMLMediaElement.setMediaKeys() Secure context

Gibt Promise zurück. Setzt die MediaKeys-Schlüssel fest, die während der Wiedergabe zur Entschlüsselung von Medien verwendet werden.

HTMLMediaElement.setSinkId() Secure context

Setzt die ID des Audiogeräts, das für die Ausgabe verwendet werden soll und gibt ein Promise zurück. Dies funktioniert nur, wenn die Anwendung autorisiert ist, das angegebene Gerät zu verwenden.

Veraltete Methoden

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

HTMLMediaElement.mozCaptureStream() Nicht standardisiert

Das Firefox-präfixierte Äquivalent von HTMLMediaElement.captureStream(). Siehe die Browser-Kompatibilität für Details.

HTMLMediaElement.mozCaptureStreamUntilEnded() Nicht standardisiert Veraltet

[Beschreibung eingeben]

HTMLMediaElement.mozGetMetadata() Nicht standardisiert Veraltet

Gibt Object zurück, das Eigenschaften enthält, die Metadaten aus der abgespielten Medienressource als {Schlüssel: Wert}-Paare darstellen. Jedes Mal, wenn die Methode aufgerufen wird, wird eine separate Kopie der Daten zurückgegeben. Diese Methode muss aufgerufen werden, nachdem das loadedmetadata Ereignis ausgelöst wurde.

Events

Erbt Ereignisse von seinem Elternteil, HTMLElement.

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Event-Listener auf die oneventname-Eigenschaft dieses Interfaces zuweisen.

abort

Ausgelöst, wenn die Ressource nicht vollständig geladen wurde, aber nicht als Ergebnis eines Fehlers.

canplay

Ausgelöst, wenn der Benutzeragent das Medium abspielen kann, jedoch schätzt, dass nicht genug Daten geladen wurden, um das Medium bis zum Ende abzuspielen, ohne für weiteres Puffern von Inhalten anhalten zu müssen.

canplaythrough

Ausgelöst, wenn der Benutzeragent das Medium abspielen kann und schätzt, dass genug Daten geladen wurden, um das Medium bis zum Ende abzuspielen, ohne für weiteres Puffern von Inhalten anhalten zu müssen.

durationchange

Ausgelöst, wenn die Eigenschaft "Dauer" aktualisiert wurde.

emptied

Ausgelöst, wenn das Medium leer geworden ist; zum Beispiel, wenn das Medium bereits geladen (oder teilweise geladen) wurde und die HTMLMediaElement.load()-Methode aufgerufen wird, um es neu zu laden.

encrypted

Ausgelöst, wenn Initialisierungsdaten im Medium gefunden werden, die darauf hinweisen, dass es verschlüsselt ist.

ended

Ausgelöst, wenn die Wiedergabe stoppt, weil das Ende des Mediums (z. B. <audio> oder <video>) erreicht ist oder weil keine weiteren Daten verfügbar sind.

error

Ausgelöst, wenn die Ressource aufgrund eines Fehlers nicht geladen werden konnte.

loadeddata

Ausgelöst, wenn der erste Frame des Mediums geladen ist.

loadedmetadata

Ausgelöst, wenn die Metadaten geladen wurden.

loadstart

Ausgelöst, wenn der Browser begonnen hat, eine Ressource zu laden.

pause

Ausgelöst, wenn eine Anfrage zum Pausieren der Wiedergabe bearbeitet wurde und die Aktivität ihren pausierten Zustand erreicht hat, meist tritt dies auf, wenn die HTMLMediaElement.pause()-Methode des Mediums aufgerufen wird.

play

Ausgelöst, wenn die paused-Eigenschaft von true auf false geändert wird, als Ergebnis der HTMLMediaElement.play()-Methode oder des autoplay-Attributs.

playing

Ausgelöst, wenn die Wiedergabe bereit ist, nach einer Pause oder Verzögerung aufgrund von Datenmangel zu starten.

progress

Wird periodisch ausgelöst, während der Browser eine Ressource lädt.

ratechange

Ausgelöst, wenn sich die Wiedergabegeschwindigkeit geändert hat.

seeked

Ausgelöst, wenn eine Suchoperation abgeschlossen ist.

seeking

Ausgelöst, wenn eine Suchoperation beginnt.

stalled

Ausgelöst, wenn der Benutzeragent versucht, Mediendaten zu laden, aber unerwarteterweise keine Daten kommen.

suspend

Ausgelöst, wenn das Laden von Mediendaten ausgesetzt wurde.

timeupdate

Ausgelöst, wenn die Zeit, die durch die currentTime-Eigenschaft angegeben wird, aktualisiert wurde.

volumechange

Ausgelöst, wenn sich die Lautstärke geändert hat.

waiting

Ausgelöst, wenn die Wiedergabe aufgrund eines vorübergehenden Mangels an Daten gestoppt wurde.

Spezifikationen

Specification
HTML Standard
# htmlmediaelement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Referenzen

Leitfäden