HTMLMediaElement

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 vorhanden sind, um dies ohne Unterbrechung zu tun.

Hinweis: Das automatische Abspielen von Audio, wenn der Benutzer es nicht erwartet oder wünscht, ist ein schlechtes Benutzererlebnis und sollte in den meisten Fällen vermieden werden, obwohl es Ausnahmen gibt. Weitere Informationen finden Sie im Autoplay-Leitfaden für Medien- und Web-Audio-APIs. Beachten Sie, dass Browser Autoplay-Anfragen möglicherweise ignorieren. 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 aktuell gepuffert hat (falls vorhanden), wenn 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 Steuerelemente auf dem Medienelement angezeigt werden sollen, wenn der Benutzeragent sein eigenes Set von Steuerelementen 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 Wert mit doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn die Medien nicht gestartet und nicht gesucht wurden, entspricht dieser Wert der anfänglichen Wiedergabezeit der Medien. Das Setzen dieses Wertes sucht die Medien zu der neuen Zeit. Die Zeit wird relativ zur Zeitleiste der Medien angegeben.

HTMLMediaElement.defaultMuted

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

HTMLMediaElement.defaultPlaybackRate

Ein double, der die Standardwiedergaberate für die Medien angibt.

HTMLMediaElement.disableRemotePlayback

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

HTMLMediaElement.duration Schreibgeschützt

Ein schreibgeschützter Wert mit doppelter Genauigkeit, der die Gesamtdauer der Medien in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, ist der zurückgegebene Wert NaN. Wenn die Medien von unbestimmter Länge sind (z. B. gestreamte Live-Medien, die Medien eines WebRTC-Anrufs oder ähnliches), ist der Wert Infinity.

HTMLMediaElement.ended Schreibgeschützt

Gibt einen booleschen Wert zurück, der anzeigt, ob das Medienelement das Abspielen 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 neu starten soll, wenn es das Ende erreicht.

HTMLMediaElement.mediaKeys Schreibgeschützt Sicherer Kontext

Gibt ein MediaKeys Objekt zurück, das ein 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 es null sein.

HTMLMediaElement.muted

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

HTMLMediaElement.networkState Schreibgeschützt

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

HTMLMediaElement.paused Schreibgeschützt

Gibt einen booleschen Wert zurück, der anzeigt, ob das Medienelement angehalten ist.

HTMLMediaElement.playbackRate

Ein double, der die Wiedergabegeschwindigkeit der Medien angibt.

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 vorgeladen 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 der Geschwindigkeit des Audios an.

HTMLMediaElement.readyState Schreibgeschützt

Gibt ein unsigned short (Enumeration) zurück, das den Bereitschaftszustand der Medien 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 anzeigt, ob die Medien dabei sind, an eine neue Position zu springen.

HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext

Gibt einen String zurück, der die eindeutige ID des Audiogeräts angibt, das eine 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 nicht zugewiesen.

HTMLMediaElement.textTracks Schreibgeschützt

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

HTMLMediaElement.videoTracks Schreibgeschützt

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

HTMLMediaElement.volume

Ein double, der die Lautstärke angibt, von 0.0 (stumm) bis 1.0 (am lautesten).

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

HTMLMediaElement.mozAudioCaptured Schreibgeschützt Nicht standardisiert Veraltet

Gibt einen booleschen Wert zurück. Bezogen auf die Erfassung des Audiostreams.

HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet

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

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

HTMLMediaElement.addTextTrack()

Fügt ein neues TextTrack Objekt (z. B. eine Spur für Untertitel) einem Medienelement hinzu. Dies ist eine rein programmatische Schnittstelle und hat keinen Einfluss auf das DOM.

HTMLMediaElement.captureStream()

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

HTMLMediaElement.canPlayType()

Gegeben ein String, der einen MIME-Medientyp angibt (möglicherweise mit dem codecs Parameter), gibt canPlayType() den String probably zurück, wenn die Medien abspielbar sein sollten, maybe, wenn nicht genügend Informationen vorliegen, um zu bestimmen, ob die Medien abgespielt werden können oder nicht, oder einen leeren String, wenn die Medien nicht abgespielt werden können.

HTMLMediaElement.fastSeek()

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

HTMLMediaElement.load()

Setzt die Medien an den Anfang zurück und wählt die beste verfügbare Quelle aus den mittels des src Attributs oder des <source> Elements bereitgestellten Quellen aus.

HTMLMediaElement.pause()

Pausiert die Medienwiedergabe.

HTMLMediaElement.play()

Beginnt die Wiedergabe der Medien.

HTMLMediaElement.seekToNextFrame() Veraltet Nicht standardisiert

Springt zum nächsten Frame in den Medien. Diese nicht standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien mit benutzerdefinierter Geschwindigkeit manuell zu steuern oder frameweise durch die Medien zu gehen, um Filterungen oder andere Vorgänge durchzuführen.

HTMLMediaElement.setMediaKeys() Sicherer Kontext

Gibt Promise zurück. Setzt die MediaKeys Schlüssel, die bei der Entschlüsselung von Medien während der Wiedergabe zu verwenden sind.

HTMLMediaElement.setSinkId() Sicherer Kontext

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

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

HTMLMediaElement.mozCaptureStream() Nicht standardisiert

Das Firefox-spezifische Gegenstück von HTMLMediaElement.captureStream(). Siehe deren Browser-Kompatibilität für Details.

HTMLMediaElement.mozCaptureStreamUntilEnded() Nicht standardisiert Veraltet

[Beschreibung einfügen]

HTMLMediaElement.mozGetMetadata() Nicht standardisiert Veraltet

Gibt Object zurück, das Eigenschaften enthält, die Metadaten der abspielenden 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.

Erbt Ereignisse von seinem Vorfahren HTMLElement.

Diese Ereignisse können mit addEventListener() überwacht werden oder indem ein Ereignislistener der oneventname Eigenschaft dieses Interfaces zugewiesen wird.

abort

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

canplay

Wird ausgelöst, wenn der Benutzeragent die Medien abspielen kann, aber schätzt, dass nicht genügend Daten geladen wurden, um die Medien bis zum Ende abzuspielen, ohne für weiteres Puffern von Inhalten anzuhalten.

canplaythrough

Wird ausgelöst, wenn der Benutzeragent die Medien abspielen kann und schätzt, dass genügend Daten geladen wurden, um die Medien bis zum Ende abzuspielen, ohne für weiteres Puffern von Inhalten anzuhalten.

durationchange

Wird ausgelöst, wenn die Eigenschaft duration aktualisiert wurde.

emptied

Wird ausgelöst, wenn die Medien leer geworden sind; zum Beispiel, wenn die Medien bereits geladen (oder teilweise geladen) wurden und die Methode HTMLMediaElement.load() aufgerufen wird, um sie neu zu laden.

encrypted

Wird ausgelöst, wenn Initialisierungsdaten in den Medien gefunden werden, die darauf hinweisen, dass die Medien verschlüsselt sind.

ended

Wird ausgelöst, wenn die Wiedergabe stoppt, wenn das Ende der Medien (<audio> oder <video>) erreicht wird 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 zum Anhalten der Wiedergabe bearbeitet wird und die Aktivität ihren pausierten Zustand erreicht hat, was meist auftritt, wenn die Methode HTMLMediaElement.pause() des Mediums aufgerufen wird.

play

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

playing

Wird ausgelöst, wenn die Wiedergabe nach einer Pause oder einer Verzögerung aufgrund fehlender Daten startbereit ist.

progress

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

ratechange

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

seeked

Wird ausgelöst, wenn eine Suchoperation abgeschlossen ist.

seeking

Wird ausgelöst, wenn eine Suchoperation beginnt.

stalled

Wird ausgelöst, wenn der Benutzeragent versucht, Mediendaten abzurufen, aber keine Daten unerwartet verfügbar sind.

suspend

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

timeupdate

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

volumechange

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

waiting

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

waitingforkey

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

• <video> und <audio> HTML Elemente
• HTMLVideoElement und HTMLAudioElement Interfaces, abgeleitet von HTMLMediaElement

• Web-Medientechnologien
• Lernbereich: HTML Video und Audio
• Medientypen- und Formatleitfaden
• Umgang mit Medienunterstützungsproblemen in Webinhalten