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 die Eigenschaften und Methoden, die benötigt werden, um grundlegende medienbezogene Fähigkeiten zu unterstützen, die für Audio und Video üblich sind.

Die Elemente HTMLVideoElement und HTMLAudioElement erben beide dieses 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 auflistet, die im Element enthalten sind.

HTMLMediaElement.autoplay

Ein boolescher Wert, der das HTML-Attribut autoplay reflektiert und anzeigt, 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, bietet eine schlechte Benutzererfahrung und sollte in den meisten Fällen vermieden werden, obwohl es Ausnahmen gibt. Siehe den Autoplay-Leitfaden für Media- und Web Audio-APIs für weitere Informationen. Beachten Sie, dass Browser Autoplay-Anfragen möglicherweise ignorieren, daher sollten Sie sicherstellen, dass Ihr Code nicht davon abhängt, dass Autoplay funktioniert.

HTMLMediaElement.buffered Schreibgeschützt

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

HTMLMediaElement.controls

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

HTMLMediaElement.controlsList Schreibgeschützt

Gibt eine DOMTokenList zurück, die dem Nutzeragenten hilft auszuwählen, welche Steuerelemente auf dem Medienelement angezeigt werden sollen, wann immer der Nutzeragent 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 ausgewählten Medienressource zurück.

HTMLMediaElement.currentTime

Ein Gleitkommawert mit doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium noch nicht abgespielt wurde und nicht gesucht wurde, ist dieser Wert die anfängliche Wiedergabezeit des Mediums. Das Setzen dieses Wertes sucht das Medium an die neue Zeit. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.

HTMLMediaElement.defaultMuted

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

HTMLMediaElement.defaultPlaybackRate

Ein double, das die Standardwiedergabegeschwindigkeit für das Medium angibt.

HTMLMediaElement.disableRemotePlayback

Ein boolescher Wert, der den Zustand der Fernwiedergabe setzt oder zurückgibt und angibt, ob es dem Medienelement erlaubt ist, ein Fernwiedergabe-Benutzerinterface zu haben.

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, ist der zurückgegebene Wert NaN. Wenn das Medium eine unbestimmte Länge hat (z.B. gestreamte Live-Medien, 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 die Wiedergabe beendet hat.

HTMLMediaElement.error Schreibgeschützt

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 HTML-Attribut loop reflektiert und angibt, ob das Medienelement neu starten sollte, wenn es das Ende erreicht.

HTMLMediaElement.mediaKeys Schreibgeschützt Sicherer Kontext

Gibt ein MediaKeys-Objekt zurück, das ein Set von Schlüsseln ist, das 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 das Audio stummgeschaltet ist. true, wenn das Audio stummgeschaltet ist, andernfalls false.

HTMLMediaElement.networkState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der den aktuellen Zustand des Abrufens des Mediums ü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, das die Geschwindigkeit angibt, mit der das Medium wiedergegeben wird.

HTMLMediaElement.played Schreibgeschützt

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

HTMLMediaElement.preload

Ein String, der das HTML-Attribut preload reflektiert 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 Tons 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 der Instanz des Medienelements zugeordnet ist.

HTMLMediaElement.seekable Schreibgeschützt

Gibt ein TimeRanges-Objekt zurück, das die Zeitbereiche enthält, zu denen der Benutzer gegebenenfalls suchen kann.

HTMLMediaElement.seeking Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das Medium im Prozess ist, an eine neue Position zu suchen.

HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext

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

HTMLMediaElement.src

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

HTMLMediaElement.srcObject

Ein Objekt, das als Quelle des mit dem HTMLMediaElement verbundenen Mediums 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 des Audios von 0.0 (lautlos) 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 HTML-Attribut mediagroup reflektiert, welches den Namen der Gruppe von Elementen angibt, zu der es gehört. Eine Gruppe von Medienelementen teilt einen gemeinsamen MediaController.

HTMLMediaElement.mozAudioCaptured Schreibgeschützt Nicht standardisiert Veraltet

Gibt einen booleschen Wert zurück. Bezieht sich auf die Aufnahme von Audio-Streams.

HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet

Ein double, der auf die Fragment-Endzeit zugreift, wenn das Medienelement eine Fragment-URI für currentSrc hat, ansonsten entspricht es der Medienlänge.

Instanz-Methoden

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 nur eine programmgesteuerte Schnittstelle und beeinflusst nicht den DOM.

HTMLMediaElement.captureStream()

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

HTMLMediaElement.canPlayType()

Angesichts eines Strings, der einen MIME-Mediendatentyp (möglicherweise mit dem codecs-Parameter enthalten) angibt, gibt canPlayType() den String probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn nicht genügend Informationen vorhanden sind, um festzustellen, ob das Medium abgespielt wird oder nicht, oder einen leeren String, wenn das Medium nicht abgespielt werden kann.

HTMLMediaElement.fastSeek()

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

Sucht zum nächsten Frame im Medium. Diese nicht standardisierte, experimentelle Methode ermöglicht es, die Lese- und Rendering-Geschwindigkeit des Mediums manuell zu steuern oder das Medium frameweise zu durchlaufen, um Filterung oder andere Operationen durchzuführen.

HTMLMediaElement.setMediaKeys() Sicherer Kontext

Gibt Promise zurück. Setzt die MediaKeys-Schlüssel, die zur 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äfixierte Äquivalent von HTMLMediaElement.captureStream(). Siehe die 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 aus der spielenden Medienressource als {key: value}-Paaren repräsentieren. Jedes Mal, wenn die Methode aufgerufen wird, wird eine separate Kopie der Daten zurückgegeben. Diese Methode muss nach dem Auftreten des loadedmetadata-Ereignisses aufgerufen werden.

Ereignisse

Erbt Ereignisse von seinem Elternteil, HTMLElement.

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener an die oneventname-Eigenschaft dieser Schnittstelle zuteilen.

abort

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

canplay

Wird ausgelöst, wenn der Nutzeragent das Medium abspielen kann, aber schätzt, dass nicht genügend Daten geladen wurden, um das Medium bis zum Ende ohne weiteres Puffern von Inhalten abzuspielen.

canplaythrough

Wird ausgelöst, wenn der Nutzeragent das Medium abspielen kann und schätzt, dass genügend Daten geladen wurden, um das Medium bis zum Ende ohne weiteres Puffern von Inhalten abzuspielen.

durationchange

Wird ausgelöst, wenn die Dauer-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 anzeigen, dass das Medium verschlüsselt ist.

ended

Wird ausgelöst, wenn die Wiedergabe stoppt, weil das Ende des Mediums (<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 das erste Bild des Mediums 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 Anfrage zur Pausierung der Wiedergabe verarbeitet wurde und die Aktivität ihren pausierten Zustand erreicht hat, was am häufigsten 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, infolge der HTMLMediaElement.play()-Methode oder des autoplay-Attributs.

playing

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

progress

Wird periodisch ausgelöst, wenn 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 Nutzeragent versucht, Mediendaten abzurufen, aber unerwartet keine Daten kommen.

suspend

Wird ausgelöst, wenn das Laden von Mediendaten angehalten 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 aufgrund eines vorübergehenden Mangels an Daten gestoppt wurde.

waitingforkey

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

Spezifikationen

Specification
HTML
# htmlmediaelement

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLMediaElement
abort event
addTextTrack
audioTracks
autoplay
buffered
canPlayType()
canplay event
canplaythrough event
captureStream
controller
DeprecatedNon-standard
controls
controlsList
crossOrigin
currentSrc
currentTime
defaultMuted
defaultPlaybackRate
disableRemotePlayback
duration
durationchange event
emptied event
encrypted event
ended
ended event
error
error event
fastSeek
getStartDate
load
loadeddata event
loadedmetadata event
loadstart event
loop
mediaGroup
DeprecatedNon-standard
mediaKeys
mozAudioCaptured
DeprecatedNon-standard
mozCaptureStreamUntilEnded
DeprecatedNon-standard
mozFragmentEnd
DeprecatedNon-standard
mozGetMetadata
DeprecatedNon-standard
muted
networkState
pause
pause event
paused
play
Returns a Promise
play event
playbackRate
played
playing event
preload
preservesPitch
progress event
ratechange event
readyState
remote
seekToNextFrame
DeprecatedNon-standard
seekable
seeked event
seeking
seeking event
setMediaKeys
setSinkId
sinkId
src
srcObject
stalled event
suspend event
textTracks
timeupdate event
videoTracks
volume
volumechange event
waiting event
waitingforkey event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Uses a non-standard name.
Requires a vendor prefix or different name for use.
Has more compatibility info.

Siehe auch

Referenzen

Leitfäden