HTMLMediaElement

Instanz-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihren Vorfahren HTMLElement, Element, Node, und EventTarget.

HTMLMediaElement.audioTracks Schreibgeschützt

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

HTMLMediaElement.autoplay

Ein boolescher Wert, der das HTML-Attribut autoplay widerspiegelt und angibt, ob die Wiedergabe automatisch beginnen soll, sobald genügend Medien verfügbar sind, um sie unterbrechungsfrei abzuspielen.

HTMLMediaElement.buffered Schreibgeschützt

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

HTMLMediaElement.controls

Ein boolescher Wert, der das HTML-Attribut controls 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, wann immer der Benutzeragent seine eigene Kontrollsatz anzeigt. Die DOMTokenList kann einen oder mehrere der drei möglichen Werte enthalten: 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 mit doppelter Genauigkeit, 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 springt das Medium zu der neuen Zeit. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.

HTMLMediaElement.defaultMuted

Ein boolescher Wert, das das HTML-Attribut muted widerspiegelt, welches 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 Fernwiedergabe setzt oder zurückgibt und angibt, ob das Medienelement eine UI für die Fernwiedergabe haben darf.

HTMLMediaElement.duration Schreibgeschützt

Ein schreibgeschützter Gleitkommawert mit doppelter Genauigkeit, der die Gesamtdauer des Mediums in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, wird der Wert NaN zurückgegeben. Wenn das Medium eine unbestimmte Länge hat (wie bei gestreamten Live-Medien, einem WebRTC-Anrufmedium oder ähnlichem), ist der Wert Infinity.

HTMLMediaElement.ended Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, 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 es keinen Fehler gegeben hat.

HTMLMediaElement.loading

Ein String, der angibt, ob der Browser das Medium sofort (eager) oder bei Bedarf (lazy) laden soll. Siehe HTML-Attribute <video loading> und <audio loading> für mehr Informationen.

HTMLMediaElement.loop

Ein boolescher Wert, der das HTML-Attribut loop widerspiegelt, welches angibt, ob das Medienelement erneut beginnen 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 verwenden kann, um Mediendaten während der Wiedergabe zu entschlüsseln. Wenn kein Schlüssel verfügbar ist, kann es null sein.

HTMLMediaElement.muted

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

HTMLMediaElement.networkState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der den aktuellen Zustand des Abrufs des Mediums über das Netzwerk anzeigt.

HTMLMediaElement.paused Schreibgeschützt

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

HTMLMediaElement.playbackRate

Ein double, das 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 HTML-Attribut preload 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 Klangs beibehalten wird. Wenn auf false gesetzt, passt sich die Tonhöhe an die 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 eine Instanz des RemotePlayback-Objekts 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 dabei ist, eine neue Position zu suchen.

HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext

Gibt einen String zurück, der die eindeutige ID des Ausgabegeräts für Audio darstellt, oder einen leeren String, wenn das Standard-Audiogerät des Benutzeragenten verwendet wird.

HTMLMediaElement.src

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

HTMLMediaElement.srcObject

Ein Objekt, das als Quelle des mit dem HTMLMediaElement verknüpften Mediums 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, 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 mehr verwendet werden, auch wenn ein Browser sie noch unterstützt.

HTMLMediaElement.controller

Ein MediaController-Objekt, das den Media-Controller repräsentiert, der dem Element zugewiesen ist, oder null, wenn keiner zugewiesen ist.

HTMLMediaElement.mediaGroup

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 einen gemeinsamen MediaController.

HTMLMediaElement.mozAudioCaptured Schreibgeschützt

Gibt einen booleschen Wert zurück. Bezieht sich auf die Erfassung von Audiostreams.

HTMLMediaElement.mozFragmentEnd

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

Instanz-Methoden

Diese Schnittstelle erbt auch Methoden von ihren Vorfahren HTMLElement, Element, Node, und EventTarget.

HTMLMediaElement.addTextTrack()

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

HTMLMediaElement.captureStream()

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

HTMLMediaElement.canPlayType()

Bei Angabe eines Strings, der einen MIME Medientyp (möglicherweise mit dem codecs Parameter) spezifiziert, gibt canPlayType() den String probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn nicht genügend Informationen vorliegen, um festzustellen, ob das Medium abgespielt wird oder nicht, oder einen leeren String, wenn das Medium nicht abgespielt werden kann.

HTMLMediaElement.fastSeek()

Sucht schnell mit geringer Präzision zur angegebenen Zeit.

HTMLMediaElement.getStartDate()

Gibt ein Date-Objekt zurück, das das reale Datum und die Uhrzeit repräsentiert, die dem Beginn des Mediums entsprechen. Für Live-Streams ist dies die Zeit, zu der die Übertragung auf dem Server begann, was vor dem Zeitpunkt sein kann, zu dem der Benutzer mit dem Anschauen begann.

HTMLMediaElement.load()

Setzt das Medium an den Anfang zurück und wählt die beste verfügbare Quelle aus den mithilfe des src-Attributs oder dem <source>-Element bereitgestellten Quellen aus.

HTMLMediaElement.pause()

Pausiert die Medienwiedergabe.

HTMLMediaElement.play()

Beginnt die Wiedergabe des Mediums.

HTMLMediaElement.seekToNextFrame()

Sucht 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 durch das Medium Bild für Bild zu navigieren, um Filterung oder andere Operationen durchzuführen.

HTMLMediaElement.setMediaKeys() Sicherer Kontext

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

HTMLMediaElement.setSinkId() Sicherer Kontext

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 berechtigt ist, das angegebene Gerät zu verwenden.

Veraltete Methoden

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

HTMLMediaElement.mozCaptureStream()

Die mit einem Firefox-Präfix versehene Entsprechung von HTMLMediaElement.captureStream(). Siehe dessen Browser-Kompatibilität für Details.

HTMLMediaElement.mozCaptureStreamUntilEnded()

Eine nicht standardisierte, veraltete Methode zum Erfassen des Streams, bis dieser zu Ende ist.

HTMLMediaElement.mozGetMetadata()

Gibt ein Object zurück, das Eigenschaften enthält, die Metadaten aus der abspielenden Medienquelle als {key: value}-Paare repräsentieren. 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

Ereignisse von seinem übergeordneten Element, HTMLElement, werden geerbt.

Diese Ereignisse können mit addEventListener() gehört werden oder durch Zuweisung eines Event-Listeners zur oneventname-Eigenschaft dieser Schnittstelle.

abort

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

canplay

Wird ausgelöst, wenn der Benutzeragent das Medium abspielen kann, jedoch schätzt, dass nicht genügend Daten geladen wurden, um das Medium bis zum Ende abzuspielen, ohne für weiteres Puffern des Inhalts 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 des Inhalts anhalten zu müssen.

durationchange

Wird ausgelöst, wenn die Eigenschaft für die Dauer aktualisiert wurde.

emptied

Wird ausgelöst, wenn das Medium leer geworden ist; zum Beispiel, wenn das Medium bereits geladen ist (oder teilweise geladen war) und die Methode HTMLMediaElement.load() 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, 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 fertig geladen ist.

loadedmetadata

Wird ausgelöst, wenn Metadaten geladen wurden.

loadstart

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

pause

Wird ausgelöst, wenn ein Pausieren der Wiedergabe angefordert wurde und die Aktivität ihren pausierten Zustand erreicht hat, am häufigsten wenn die Methode HTMLMediaElement.pause() des Mediums aufgerufen wird.

play

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

playing

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

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 ein Suchvorgang abgeschlossen ist.

seeking

Wird ausgelöst, wenn ein Suchvorgang beginnt.

stalled

Wird ausgelöst, wenn der Benutzeragent versucht, Mediendaten abzurufen, Daten jedoch unerwartet nicht bereitgestellt werden.

suspend

Wird ausgelöst, wenn das Laden der Mediendaten angehalten wurde.

timeupdate

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

volumechange

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

waiting

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

waitingforkey

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

Spezifikationen

Spezifikation

HTML # htmlmediaelement

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

Referenzen

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

Leitfäden

• Web-Medientechnologien
• Lernbereich: HTML-Video und -Audio
• Medientyp- und Format-Leitfaden
• Umgang mit Unterstützung von Medieninhalten in Web-Inhalten