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 nötig sind, um grundlegende medienbezogene Funktionen zu unterstützen, die bei Audio und Video üblich sind.

Die Elemente HTMLVideoElement und HTMLAudioElement erben beide von diesem Interface.

EventTarget Node Element HTMLElement HTMLMediaElement

Instanz-Eigenschaften

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

HTMLMediaElement.audioTracks

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

HTMLMediaElement.autoplay

Ein boolescher Wert, der das autoplay-HTML-Attribut widerspiegelt und angibt, ob die Wiedergabe automatisch beginnen soll, sobald genug Medien vorhanden sind, um dies ohne Unterbrechung zu ermöglichen.

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 Autoplay-Leitfaden für Medien und Web Audio APIs für weitere Informationen. Beachten Sie, dass Browser Autoplay-Anfragen ignorieren können, daher sollten Sie sicherstellen, dass Ihr Code nicht davon abhängig ist, dass Autoplay funktioniert.

HTMLMediaElement.buffered Nur lesbar

Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Medienquelle angibt, die der Browser (falls vorhanden) zwischengespeichert hat, wenn die buffered-Eigenschaft aufgerufen wird.

HTMLMediaElement.controls

Ein boolescher Wert, der das controls-HTML-Attribut widerspiegelt und angibt, ob Benutzerschnittstellenelemente 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, wenn der Benutzeragent seine eigene Steuerelemente anzeigt. Die DOMTokenList nimmt eine 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 ausgewählten Medienressource zurück.

HTMLMediaElement.currentTime

Ein Gleitkomma-Doppelwert, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium noch nicht mit der Wiedergabe begonnen hat und nicht gesucht wurde, ist dieser Wert die anfängliche Wiedergabezeit des Mediums. Das Setzen dieses Wertes sucht das Medium auf die neue Zeit. Die Zeit wird relativ zur Zeitachse des Mediums angegeben.

HTMLMediaElement.defaultMuted

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

HTMLMediaElement.defaultPlaybackRate

Ein double-Wert, der die Standard-Wiedergabegeschwindigkeit für das Medium angibt.

HTMLMediaElement.disableRemotePlayback

Ein boolescher Wert, der den Status der entfernten Wiedergabe setzt oder zurückgibt und angibt, ob dem Medienelement eine entfernte Wiedergabe-UI erlaubt ist.

HTMLMediaElement.duration Nur lesbar

Ein schreibgeschützter Gleitkomma-Doppelwert, 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 zum Beispiel gestreamte Live-Medien, Medien eines WebRTC-Anrufs oder ähnliches), ist der Wert +Infinity.

HTMLMediaElement.ended Nur lesbar

Gibt einen booleschen Wert zurück, der anzeigt, ob das Medienelement die Wiedergabe beendet hat.

HTMLMediaElement.error Nur lesbar

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

HTMLMediaElement.loop

Ein boolescher Wert, der das loop-HTML-Attribut widerspiegelt und 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 einen Satz von Schlüsseln enthält, 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 Audio stummgeschaltet ist. true, wenn das Audio stummgeschaltet ist, und false andernfalls.

HTMLMediaElement.networkState Nur lesbar

Gibt ein unsigned short (Aufzählung) zurück, das den aktuellen Status des Medienabrufs über das Netzwerk angibt.

HTMLMediaElement.paused Nur lesbar

Gibt einen booleschen Wert zurück, der angibt, ob das Medienelement pausiert ist.

HTMLMediaElement.playbackRate

Ein double, der die Rate angibt, mit der das Medium wiedergegeben wird.

HTMLMediaElement.played Nur lesbar

Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Medienquelle enthält, die der Browser (falls vorhanden) wiedergegeben hat.

HTMLMediaElement.preload

Ein String, der das preload-HTML-Attribut widerspiegelt und angibt, welche Daten vorgeladen werden sollen, falls vorhanden. Mögliche Werte sind: none, metadata, auto.

HTMLMediaElement.preservesPitch

Ein boolescher Wert, der bestimmt, ob die Tonhöhe des Sounds erhalten bleibt. Wenn auf false gesetzt, passt sich die Tonhöhe an die Geschwindigkeit des Audios an.

HTMLMediaElement.readyState Nur lesbar

Gibt ein unsigned short (Aufzählung) zurück, das den Bereitschaftszustand des Mediums angibt.

HTMLMediaElement.remote Nur lesbar

Gibt eine Instanz des RemotePlayback-Objekts zurück, die dem Medienelement zugeordnet 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 einen booleschen Wert zurück, der anzeigt, ob das Medium gerade dabei ist, zu einer neuen Position zu suchen.

HTMLMediaElement.sinkId Nur lesbar Secure context

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

HTMLMediaElement.src

Ein String, der das src-HTML-Attribut widerspiegelt und die URL einer Mediendatei enthält, die verwendet werden soll.

HTMLMediaElement.srcObject

Ein Objekt, das als Quelle der Medien dient, die mit dem HTMLMediaElement verbunden sind, oder null, wenn nicht zugewiesen.

HTMLMediaElement.textTracks Nur lesbar

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

HTMLMediaElement.videoTracks Nur lesbar

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

HTMLMediaElement.volume

Ein double, das die Lautstärke des Audios angibt, von 0,0 (leise) 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 zugeordneten Mediencontroller darstellt, oder null, wenn keiner zugewiesen ist.

HTMLMediaElement.mediaGroup Veraltet Nicht standardisiert

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

HTMLMediaElement.mozAudioCaptured Nur lesbar Nicht standardisiert Veraltet

Gibt einen booleschen Wert zurück. Bezieht sich auf das Erfassen von Audiostreams.

HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet

Ein double, der Zugriff auf das Fragmentendzeit ermöglicht, wenn das Medienelement eine Fragment-URI für currentSrc hat, andernfalls entspricht er der Medienlänge.

Instanz-Methoden

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

HTMLMediaElement.addTextTrack()

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

HTMLMediaElement.captureStream()

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

HTMLMediaElement.canPlayType()

Bei einem String, der einen MIMEmedia-Typ angibt (ggf. mit einbezogenem codecs-Parameter), gibt canPlayType() den String probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn nicht genug Informationen vorhanden sind, um zu bestimmen, ob das Medium abspielbar ist oder nicht, oder einen leeren String, wenn das Medium nicht abgespielt werden kann.

HTMLMediaElement.fastSeek()

Sucht schnell mit niedriger Präzision zu der angegebenen Zeit.

HTMLMediaElement.load()

Setzt das Medium auf den Anfang zurück und wählt die bestmögliche Quelle aus den bereitgestellten Quellen mithilfe des src-Attributs oder des <source>-Elements aus.

HTMLMediaElement.pause()

Hält die Medienwiedergabe an.

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 mit einer benutzerdefinierten Geschwindigkeit manuell zu steuern, oder um durch das Medium Frame für Frame zu navigieren, um Filterung oder andere Operationen durchzuführen.

HTMLMediaElement.setMediaKeys() Secure context

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

HTMLMediaElement.setSinkId() Secure context

Legt die ID des Audiogeräts fest, 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-spezifische Äquivalent zu HTMLMediaElement.captureStream(). Siehe die Browser-Kompatibilität für Details.

HTMLMediaElement.mozCaptureStreamUntilEnded() Nicht standardisiert Veraltet

[enter description]

HTMLMediaElement.mozGetMetadata() Nicht standardisiert Veraltet

Gibt Object zurück, das Eigenschaften enthält, die Metadaten der abspielenden Medienressource als {key: value}-Paare repräsentieren. Eine separate Kopie der Daten wird bei jedem Aufruf der Methode zurückgegeben. Diese Methode muss nach dem loadedmetadata-Ereignis aufgerufen werden.

Ereignisse

Erbt Ereignisse von seinem Elternteil, HTMLElement.

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuweisen eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces.

abort

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

canplay

Wird 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 anhalten zu müssen.

canplaythrough

Wird 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 anhalten zu müssen.

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 die HTMLMediaElement.load()-Methode aufgerufen wird, um es neu zu laden.

encrypted

Wird ausgelöst, wenn Initialisierungsdaten im Medium gefunden werden, die darauf hinweisen, dass das Medium verschlüsselt ist.

ended

Wird ausgelöst, wenn die Wiedergabe stoppt, weil das Ende der Medien (<audio> oder <video>) erreicht wurde 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 geladen ist.

loadedmetadata

Wird ausgelöst, wenn die Metadaten geladen sind.

loadstart

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

pause

Wird ausgelöst, wenn eine Anfrage, das Abspielen zu pausieren, verarbeitet wird und die Aktivität ihren pausierten Zustand erreicht hat, was meistens auftritt, wenn die HTMLMediaElement.pause()-Methode des Mediums aufgerufen wird.

play

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

playing

Wird ausgelöst, wenn die Wiedergabe bereit ist zu starten, nachdem sie pausiert oder aufgrund mangelnder Daten verzögert wurde.

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 begonnen hat.

stalled

Wird ausgelöst, wenn der Benutzeragent versucht, Mediendaten zu holen, aber unerwartet keine Daten kommen.

suspend

Wird ausgelöst, wenn das Laden von Mediendaten unterbrochen wurde.

timeupdate

Wird ausgelöst, wenn die durch die currentTime-Eigenschaft angezeigte Zeit aktualisiert wurde.

volumechange

Wird ausgelöst, wenn die Lautstärke geändert wurde.

waiting

Wird ausgelöst, wenn die Wiedergabe gestoppt wurde, weil vorübergehend Daten fehlen.

waitingforkey

Wird ausgelöst, wenn die Wiedergabe zuerst blockiert ist, während auf einen Schlüssel gewartet wird.

Spezifikationen

Specification
HTML Standard
# htmlmediaelement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Referenzen

Leitfäden