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.

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

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

Die HTMLVideoElement und HTMLAudioElement Elemente erben beide dieses 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: Audio automatisch abzuspielen, 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 zu Autoplay für Medien und Web Audio APIs für mehr Informationen. Beachten Sie, dass Browser Autoplay-Anforderungen ignorieren könnten, daher sollten Sie sicherstellen, dass Ihr Code nicht davon abhängig ist, dass Autoplay funktioniert.

HTMLMediaElement.buffered Schreibgeschützt

Gibt ein TimeRanges Objekt zurück, das die Bereiche der Medienquelle angibt, die der Browser (falls vorhanden) gepuffert hat, zu dem Zeitpunkt, zu dem die buffered Eigenschaft abgerufen wird.

HTMLMediaElement.controls

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

HTMLMediaElement.controlsList

Gibt eine DOMTokenList zurück, die dem Benutzeragenten hilft, auszuwählen, welche Steuerungselemente auf dem Medienelement angezeigt werden sollen, wann immer der Benutzeragent seine eigene Kontrolle anzeigt. 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 Schreibgeschützt

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

HTMLMediaElement.currentTime

Ein Gleitkommawert doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn die Medien noch nicht gestartet wurden und nicht gesucht wurden, 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 Zeitleiste 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 soll.

HTMLMediaElement.defaultPlaybackRate

Ein double, der die Standardwiedergaberate für das Medium angibt.

HTMLMediaElement.disableRemotePlayback

Ein boolescher Wert, der den Fernwiedergabe-Zustand festlegt oder zurückgibt und angibt, ob das Medienelement eine Fernwiedergabe-Oberfläche haben darf.

HTMLMediaElement.duration Schreibgeschützt

Ein schreibgeschützter Gleitkommawert doppelter Genauigkeit, der die Gesamtdauer des Mediums in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, ist der zurückgegebene Wert NaN. Wenn das Medium eine unbestimmte Länge hat (wie gestreamte Live-Medien, ein WebRTC-Anruf-Medium oder ähnliches), ist der Wert +Infinity.

HTMLMediaElement.ended Schreibgeschützt

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

HTMLMediaElement.error Schreibgeschützt

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 und angibt, ob das Medienelement von vorne anfangen soll, wenn es das Ende erreicht.

HTMLMediaElement.mediaKeys Schreibgeschützt Sicherer Kontext

Gibt ein MediaKeys Objekt zurück, das einen Satz von Schlüsseln enthält, den 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, wenn nicht.

HTMLMediaElement.networkState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der den aktuellen Zustand der Abfrage der Medien über das Netzwerk angibt.

HTMLMediaElement.paused Schreibgeschützt

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 Schreibgeschützt

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

HTMLMediaElement.preload

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

HTMLMediaElement.preservesPitch

Ein boolescher Wert, der bestimmt, ob die Tonhöhe des Klangs beibehalten wird. Wenn auf false gesetzt, passt sich die Tonhöhe der Geschwindigkeit des Audios an.

HTMLMediaElement.readyState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der den Bereitschaftszustand des Mediums angibt.

HTMLMediaElement.remote Schreibgeschützt

Gibt ein RemotePlayback Objekt zurück, das mit dem Medienelement verbunden ist.

HTMLMediaElement.seekable Schreibgeschützt

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

HTMLMediaElement.seeking Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das Medium gerade eine neue Position ansteuert.

HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext

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 zu verwendenden Medienressource enthält.

HTMLMediaElement.srcObject

Ein Objekt, das als Quelle der mit dem HTMLMediaElement verbundenen Medien dient, oder null, wenn es nicht zugewiesen ist.

HTMLMediaElement.textTracks Schreibgeschützt

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

HTMLMediaElement.videoTracks Schreibgeschützt

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 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.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 und angibt, zu welcher Gruppe von Elementen es gehört. Eine Gruppe von Medienelementen teilt einen gemeinsamen MediaController.

HTMLMediaElement.mozAudioCaptured Schreibgeschützt Nicht standardisiert Veraltet

Gibt einen booleschen Wert zurück. Im Zusammenhang mit Audio-Stream-Aufnahme.

HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet

Ein double, das den Zugriff auf das Fragment-Ende ermöglicht, wenn das Medienelement eine Fragment-URI für currentSrc hat, andernfalls entspricht es der Mediendauer.

Instanzmethoden

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

HTMLMediaElement.addTextTrack()

Fügt ein neues TextTrack Objekt (wie eine Spur für Untertitel) zu einem Medienelement hinzu. Dies ist eine programmgesteuerte 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-Medientyp angibt (möglicherweise mit dem codecs Parameter eingeschlossen), gibt canPlayType() den String probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn nicht genug Informationen vorliegen, um festzustellen, ob das Medium abgespielt werden kann, oder einen leeren String, wenn das Medium nicht abgespielt werden kann.

HTMLMediaElement.fastSeek()

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

HTMLMediaElement.load()

Setzt das Medium an den Anfang zurück und wählt die beste verfügbare Quelle aus den mit dem src Attribut oder dem <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 Bild im Medium. Diese nicht-standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien mit einer benutzerdefinierten Geschwindigkeit manuell zu steuern oder durch die Medien Bild für Bild zu gehen, um Filterung oder andere Operationen durchzuführen.

HTMLMediaElement.setMediaKeys() Sicherer Kontext

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

HTMLMediaElement.setSinkId() Sicherer Kontext

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 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

Das Firefox-präfigierte Äquivalent zu HTMLMediaElement.captureStream(). Siehe dessen 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 von der abgespielten Medienressource als {key: value} Paare darstellen. Eine separate Kopie der Daten wird jedes Mal zurückgegeben, wenn die Methode aufgerufen wird. Diese Methode muss nach dem loadedmetadata Ereignis aufgerufen werden.

Ereignisse

Erbt Ereignisse von seinem Elternteil, HTMLElement.

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener der oneventname Eigenschaft dieses Interface zuordnen.

abort

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

canplay

Ausgelöst, wenn der Benutzeragent das Medium abspielen kann, aber schätzt, dass nicht genug Daten geladen wurden, um das Medium bis zu seinem Ende zu spielen, 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 zu seinem Ende zu spielen, ohne für weiteres Puffern von Inhalten anhalten zu müssen.

durationchange

Ausgelöst, wenn die duration-Eigenschaft 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 in den Medien gefunden werden, die darauf hinweisen, dass die Medien verschlüsselt sind.

ended

Ausgelöst, wenn die Wiedergabe stoppt, wenn das Ende des Mediums (<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 fertig 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 Anforderung zum Pausieren der Wiedergabe bearbeitet wird und die Aktivität ihren Pausenzustand erreicht hat, was am häufigsten auftritt, 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 nach dem Pausieren oder Verzögern aufgrund von Datenmangel bereit ist zu starten.

progress

Wird regelmäßig ausgelöst, während der Browser eine Ressource lädt.

ratechange

Ausgelöst, wenn sich die Wiedergaberate ändert.

seeked

Ausgelöst, wenn ein Suchvorgang abgeschlossen ist.

seeking

Ausgelöst, wenn ein Suchvorgang beginnt.

stalled

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

suspend

Ausgelöst, wenn das Laden der Mediendaten angehalten wurde.

timeupdate

Ausgelöst, wenn die durch die currentTime Eigenschaft angegebene Zeit aktualisiert wurde.

volumechange

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

waiting

Ausgelöst, wenn die Wiedergabe aufgrund eines vorübergehenden Datenmangels gestoppt hat.

waitingforkey

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

Spezifikationen

Specification
HTML
# htmlmediaelement

Browser-Kompatibilität

Siehe auch

Referenzen

Leitfäden