HTMLMediaElement

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

HTMLMediaElement.audioTracks

Ein AudioTrackList-Objekt, das die im Element enthaltenen AudioTrack-Objekte auflistet.

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. 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 auf die buffered-Eigenschaft zugegriffen 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 Schreibgeschützt

Gibt eine DOMTokenList zurück, die dem Benutzeragenten hilft, auszuwählen, welche Steuerelemente auf dem Medienelement angezeigt werden sollen, wenn der Benutzeragent seine eigene Steuerelementsammlung 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 ausgewählten Medienressource zurück.

HTMLMediaElement.currentTime

Ein Gleitkommawert doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium noch nicht abgespielt wurde und nicht gesucht wurde, ist dieser Wert die Anfangswiedergabezeit des Mediums. Das Setzen dieses Wertes führt dazu, dass das Medium zur neuen Zeit springt. Die Zeit wird relativ zur Zeitleiste des Mediums 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 Standard-Wiedergabegeschwindigkeit für das Medium angibt.

HTMLMediaElement.disableRemotePlayback

Ein boolescher Wert, der den Status der Remote-Wiedergabe setzt oder zurückgibt und angibt, ob dem Medienelement eine Remote-Wiedergabe-Benutzeroberfläche erlaubt ist.

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 zum Beispiel 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 angibt, ob das Medienelement mit der Wiedergabe fertig ist.

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 beim Erreichen des Endes neu starten sollte.

HTMLMediaElement.mediaKeys Schreibgeschützt Sicherer Kontext

Gibt ein MediaKeys-Objekt zurück, das ein Schlüsselsatz ist, den das Element für die 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 das Audio stummgeschaltet ist, und false andernfalls.

HTMLMediaElement.networkState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der den aktuellen Zustand des Ladens 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 Geschwindigkeit angibt, mit der das Medium abgespielt 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 vorab geladen 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 der Geschwindigkeit des Audios an.

HTMLMediaElement.readyState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der 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 angibt, ob das Medium gerade versucht, zu einer neuen Position zu springen.

HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext

Gibt einen String zurück, der die eindeutige ID des Audioausgabegeräts ist, 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 verknüpften 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 des Audios angibt, von 0.0 (stumm) bis 1.0 (lautest).

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, der das Element zugehö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 die Endzeit des Fragments bietet, wenn das Medienelement eine Fragment-URI für currentSrc hat, andernfalls entspricht es der Medienlänge.

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

HTMLMediaElement.addTextTrack()

Fügt einem Medienelement ein neues TextTrack-Objekt (wie zum Beispiel eine Spur für Untertitel) hinzu. Dies ist eine rein programmatische Schnittstelle und hat keinen Einfluss auf den DOM.

HTMLMediaElement.captureStream()

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

HTMLMediaElement.canPlayType()

Mit einer Zeichenfolge, die einen MIME-Medientyp (möglicherweise mit dem codecs-Parameter enthalten) angibt, gibt canPlayType() die Zeichenfolge probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn nicht genügend Informationen vorliegen, um zu bestimmen, ob das Medium abgespielt wird oder nicht, oder eine leere Zeichenfolge, wenn das Medium nicht abgespielt werden kann.

HTMLMediaElement.fastSeek()

Springt 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 bereitgestellten Quellen mithilfe des src-Attributs oder des <source>-Elements aus.

HTMLMediaElement.pause()

Pausiert die Medienwiedergabe.

HTMLMediaElement.play()

Beginnt die Wiedergabe des Mediums.

HTMLMediaElement.seekToNextFrame() Veraltet Nicht standardisiert

Springt zum nächsten Bild im Medium. Diese nicht standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien manuell mit einer benutzerdefinierten Geschwindigkeit zu steuern oder medienbildweise zu durchlaufen, um Filterungen oder andere Operationen durchzuführen.

HTMLMediaElement.setMediaKeys() Sicherer Kontext

Gibt Promise zurück. Setzt die beim Entschlüsseln von Medien während der Wiedergabe zu verwendenden MediaKeys.

HTMLMediaElement.setSinkId() Sicherer Kontext

Setzt die ID des zu verwendenden Ausgabegeräts für Audio 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-präfixierte Äquivalent von HTMLMediaElement.captureStream(). Siehe die 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 {Schlüssel: Wert}-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, die von ihrem Elternteil, HTMLElement, geerbt werden.

Hören Sie auf diese Ereignisse mittels addEventListener() oder durch Zuweisung eines Ereignis-Abhörvorgangs zur oneventname-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 Benutzeragent das Medium abspielen kann, jedoch schätzt, dass nicht genug Daten geladen wurden, um das Medium bis zum Ende ohne weitere Zwischenspeicherung abspielen zu können.

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

durationchange

Wird ausgelöst, wenn die Eigenschaft duration 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 Methode HTMLMediaElement.load() aufgerufen wird, um es erneut 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, wenn das Ende des Mediums (<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 das erste Bild des Mediums geladen wurde.

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 ein Anhalten der Wiedergabe bearbeitet wird und die Aktivität ihren pausierten Zustand erreicht hat, tritt am häufigsten auf, wenn die Methode HTMLMediaElement.pause() des Mediums aufgerufen wird.

play

Wird ausgelöst, wenn die paused-Eigenschaft 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 Verzögerung aufgrund von Datenmangel bereit zum Starten ist.

progress

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

ratechange

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

seeked

Wird ausgelöst, wenn eine Suchoperation abgeschlossen ist.

seeking

Wird ausgelöst, wenn eine Suchoperation beginnt.

stalled

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

suspend

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

timeupdate

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

volumechange

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

waiting

Wird ausgelöst, wenn die Wiedergabe gestoppt wurde wegen einem vorübergehenden Mangel an Daten.

waitingforkey

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

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

• Web-Medientechnologien
• Lernbereich: HTML-Video und -Audio
• Leitfaden für Medientypen und -formate
• Umgang mit Medienunterstützungsproblemen in Webinhalten