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.
Das HTMLMediaElement
-Interface erweitert HTMLElement
um die Eigenschaften und Methoden, die nötig sind, um grundlegende medienbezogene Funktionen zu unterstützen, die bei Audio und Video üblich sind.
Die Elemente HTMLVideoElement
und HTMLAudioElement
erben beide von diesem Interface.
Instanz-Eigenschaften
Dieses Interface erbt auch Eigenschaften von seinen Vorfahren HTMLElement
, Element
, Node
und EventTarget
.
HTMLMediaElement.audioTracks
-
Eine
AudioTrackList
, die dieAudioTrack
-Objekte im Element auflistet. HTMLMediaElement.autoplay
-
Ein boolescher Wert, der das
autoplay
-HTML-Attribut widerspiegelt und angibt, ob die Wiedergabe automatisch beginnen soll, sobald genug Medien vorhanden sind, um dies ohne Unterbrechung zu ermöglichen.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. Siehe den Autoplay-Leitfaden für Medien und Web Audio APIs für weitere Informationen. Beachten Sie, dass Browser Autoplay-Anfragen ignorieren können, daher sollten Sie sicherstellen, dass Ihr Code nicht davon abhängig ist, dass Autoplay funktioniert.
HTMLMediaElement.buffered
Nur lesbar-
Gibt ein
TimeRanges
-Objekt zurück, das die Bereiche der Medienquelle angibt, die der Browser (falls vorhanden) zwischengespeichert hat, wenn diebuffered
-Eigenschaft aufgerufen wird. HTMLMediaElement.controls
-
Ein boolescher Wert, der das
controls
-HTML-Attribut widerspiegelt und angibt, ob Benutzerschnittstellenelemente zur Steuerung der Ressource angezeigt werden sollen. HTMLMediaElement.controlsList
Nur lesbar-
Gibt eine
DOMTokenList
zurück, die dem Benutzeragenten hilft, auszuwählen, welche Steuerelemente auf dem Medienelement angezeigt werden sollen, wenn der Benutzeragent seine eigene Steuerelemente anzeigt. DieDOMTokenList
nimmt eine oder mehrere der drei möglichen Werte an:nodownload
,nofullscreen
undnoremoteplayback
. HTMLMediaElement.crossOrigin
-
Ein String, der die CORS-Einstellung für dieses Medienelement angibt.
HTMLMediaElement.currentSrc
Nur lesbar-
Gibt einen String mit der absoluten URL der ausgewählten Medienressource zurück.
HTMLMediaElement.currentTime
-
Ein Gleitkomma-Doppelwert, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium noch nicht mit der Wiedergabe begonnen hat und nicht gesucht wurde, 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 Zeitachse 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 sollte. HTMLMediaElement.defaultPlaybackRate
-
Ein
double
-Wert, der die Standard-Wiedergabegeschwindigkeit für das Medium angibt. HTMLMediaElement.disableRemotePlayback
-
Ein boolescher Wert, der den Status der entfernten Wiedergabe setzt oder zurückgibt und angibt, ob dem Medienelement eine entfernte Wiedergabe-UI erlaubt ist.
HTMLMediaElement.duration
Nur lesbar-
Ein schreibgeschützter Gleitkomma-Doppelwert, der die Gesamtdauer des Mediums in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, ist der zurückgegebene Wert
NaN
. Wenn das Medium von unbestimmter Länge ist (wie zum Beispiel gestreamte Live-Medien, Medien eines WebRTC-Anrufs oder ähnliches), ist der Wert+Infinity
. HTMLMediaElement.ended
Nur lesbar-
Gibt einen booleschen Wert zurück, der anzeigt, ob das Medienelement die Wiedergabe beendet hat.
HTMLMediaElement.error
Nur lesbar-
Gibt ein
MediaError
-Objekt für den zuletzt aufgetretenen Fehler zurück odernull
, wenn kein Fehler aufgetreten ist. HTMLMediaElement.loop
-
Ein boolescher Wert, der das
loop
-HTML-Attribut widerspiegelt und angibt, ob das Medienelement von vorne beginnen soll, wenn es das Ende erreicht. HTMLMediaElement.mediaKeys
Nur lesbar Secure context-
Gibt ein
MediaKeys
-Objekt zurück, das einen Satz von Schlüsseln enthält, die das Element zur Entschlüsselung von Mediendaten während der Wiedergabe verwenden kann. Wenn kein Schlüssel verfügbar ist, kann esnull
sein. HTMLMediaElement.muted
-
Ein boolescher Wert, der bestimmt, ob Audio stummgeschaltet ist.
true
, wenn das Audio stummgeschaltet ist, undfalse
andernfalls. HTMLMediaElement.networkState
Nur lesbar-
Gibt ein
unsigned short
(Aufzählung) zurück, das den aktuellen Status des Medienabrufs über das Netzwerk angibt. HTMLMediaElement.paused
Nur lesbar-
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
Nur lesbar-
Gibt ein
TimeRanges
-Objekt zurück, das die Bereiche der Medienquelle enthält, die der Browser (falls vorhanden) wiedergegeben hat. 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 des Sounds erhalten bleibt. Wenn auf
false
gesetzt, passt sich die Tonhöhe an die Geschwindigkeit des Audios an. HTMLMediaElement.readyState
Nur lesbar-
Gibt ein
unsigned short
(Aufzählung) zurück, das den Bereitschaftszustand des Mediums angibt. HTMLMediaElement.remote
Nur lesbar-
Gibt eine Instanz des
RemotePlayback
-Objekts zurück, die dem Medienelement zugeordnet ist. HTMLMediaElement.seekable
Nur lesbar-
Gibt ein
TimeRanges
-Objekt zurück, das die Zeitbereiche enthält, zu denen der Benutzer springen kann, falls vorhanden. HTMLMediaElement.seeking
Nur lesbar-
Gibt einen booleschen Wert zurück, der anzeigt, ob das Medium gerade dabei ist, zu einer neuen Position zu suchen.
HTMLMediaElement.sinkId
Nur lesbar Secure context-
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 Mediendatei enthält, die verwendet werden soll. HTMLMediaElement.srcObject
-
Ein Objekt, das als Quelle der Medien dient, die mit dem
HTMLMediaElement
verbunden sind, odernull
, wenn nicht zugewiesen. HTMLMediaElement.textTracks
Nur lesbar-
Gibt ein
TextTrackList
-Objekt zurück, das die Liste derTextTrack
-Objekte enthält, die im Element enthalten sind. HTMLMediaElement.videoTracks
Nur lesbar-
Gibt ein
VideoTrackList
-Objekt zurück, das die Liste derVideoTrack
-Objekte enthält, die im Element enthalten sind. 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 verwendet werden, selbst wenn ein Browser sie noch unterstützt.
HTMLMediaElement.controller
Veraltet Nicht standardisiert-
Ein
MediaController
-Objekt, das den dem Element zugeordneten Mediencontroller darstellt, odernull
, 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 sich einen gemeinsamenMediaController
. HTMLMediaElement.mozAudioCaptured
Nur lesbar Nicht standardisiert Veraltet-
Gibt einen booleschen Wert zurück. Bezieht sich auf das Erfassen von Audiostreams.
HTMLMediaElement.mozFragmentEnd
Nicht standardisiert Veraltet-
Ein
double
, der Zugriff auf das Fragmentendzeit ermöglicht, wenn das Medienelement eine Fragment-URI fürcurrentSrc
hat, andernfalls entspricht er der Medienlänge.
Instanz-Methoden
Dieses Interface erbt auch Methoden von seinen Vorfahren HTMLElement
, Element
, Node
und EventTarget
.
HTMLMediaElement.addTextTrack()
-
Fügt einem Medienelement ein neues
TextTrack
-Objekt (wie beispielsweise eine Spur für Untertitel) hinzu. Dies ist eine rein programmatische Schnittstelle und beeinflusst das DOM nicht. HTMLMediaElement.captureStream()
-
Gibt
MediaStream
zurück und erfasst einen Stream des Medieninhalts. HTMLMediaElement.canPlayType()
-
Bei einem String, der einen MIMEmedia-Typ angibt (ggf. mit einbezogenem
codecs
-Parameter), gibtcanPlayType()
den Stringprobably
zurück, wenn das Medium abspielbar sein sollte,maybe
, wenn nicht genug Informationen vorhanden sind, um zu bestimmen, ob das Medium abspielbar ist oder nicht, oder einen leeren String, wenn das Medium nicht abgespielt werden kann. HTMLMediaElement.fastSeek()
-
Sucht schnell mit niedriger Präzision zu der angegebenen Zeit.
HTMLMediaElement.load()
-
Setzt das Medium auf den Anfang zurück und wählt die bestmögliche Quelle aus den bereitgestellten Quellen mithilfe des
src
-Attributs oder des<source>
-Elements aus. HTMLMediaElement.pause()
-
Hält die Medienwiedergabe an.
HTMLMediaElement.play()
-
Beginnt die Wiedergabe des Mediums.
HTMLMediaElement.seekToNextFrame()
Veraltet Nicht standardisiert-
Springt zum nächsten Frame im Medium. Diese nicht standardisierte, experimentelle Methode macht es möglich, das Lesen und Rendern von Medien mit einer benutzerdefinierten Geschwindigkeit manuell zu steuern, oder um durch das Medium Frame für Frame zu navigieren, um Filterung oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys()
Secure context-
Gibt
Promise
zurück. Setzt dieMediaKeys
, die bei der Entschlüsselung von Medien während der Wiedergabe verwendet werden. HTMLMediaElement.setSinkId()
Secure context-
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 autorisiert ist, das angegebene Gerät zu verwenden.
Veraltete Methoden
Diese Methoden sind veraltet und sollten nicht verwendet werden, selbst wenn ein Browser sie noch unterstützt.
HTMLMediaElement.mozCaptureStream()
Nicht standardisiert-
Das Firefox-spezifische Äquivalent zu
HTMLMediaElement.captureStream()
. Siehe die Browser-Kompatibilität für Details. HTMLMediaElement.mozCaptureStreamUntilEnded()
Nicht standardisiert Veraltet-
[enter description]
HTMLMediaElement.mozGetMetadata()
Nicht standardisiert Veraltet-
Gibt
Object
zurück, das Eigenschaften enthält, die Metadaten der abspielenden Medienressource als{key: value}
-Paare repräsentieren. Eine separate Kopie der Daten wird bei jedem Aufruf der Methode zurückgegeben. Diese Methode muss nach demloadedmetadata
-Ereignis aufgerufen werden.
Ereignisse
Erbt Ereignisse von seinem Elternteil, HTMLElement
.
Hören Sie diese Ereignisse mit addEventListener()
oder durch Zuweisen eines Ereignis-Listeners zur oneventname
-Eigenschaft dieses Interfaces.
abort
-
Wird ausgelöst, wenn die Ressource nicht vollständig geladen wurde, aber nicht als Ergebnis 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 abzuspielen, ohne für weiteres Puffern 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 anhalten zu müssen.
durationchange
-
Wird ausgelöst, wenn die
duration
-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 darauf hinweisen, dass das Medium verschlüsselt ist.
ended
-
Wird ausgelöst, wenn die Wiedergabe stoppt, weil das Ende der Medien (
<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 der erste Frame des Mediums geladen ist.
loadedmetadata
-
Wird ausgelöst, wenn die Metadaten geladen sind.
loadstart
-
Wird ausgelöst, wenn der Browser begonnen hat, eine Ressource zu laden.
pause
-
Wird ausgelöst, wenn eine Anfrage, das Abspielen zu pausieren, verarbeitet wird und die Aktivität ihren pausierten Zustand erreicht hat, was meistens auftritt, wenn die
HTMLMediaElement.pause()
-Methode des Mediums aufgerufen wird. play
-
Wird ausgelöst, wenn die
paused
-Eigenschaft vontrue
auffalse
geändert wird, als Ergebnis derHTMLMediaElement.play()
-Methode oder desautoplay
-Attributes. playing
-
Wird ausgelöst, wenn die Wiedergabe bereit ist zu starten, nachdem sie pausiert oder aufgrund mangelnder Daten verzögert wurde.
progress
-
Wird periodisch ausgelöst, während der Browser eine Ressource lädt.
ratechange
-
Wird ausgelöst, wenn die Wiedergaberate geändert wurde.
seeked
-
Wird ausgelöst, wenn ein Suchvorgang abgeschlossen ist.
seeking
-
Wird ausgelöst, wenn ein Suchvorgang begonnen hat.
stalled
-
Wird ausgelöst, wenn der Benutzeragent versucht, Mediendaten zu holen, aber unerwartet keine Daten kommen.
suspend
-
Wird ausgelöst, wenn das Laden von Mediendaten unterbrochen wurde.
timeupdate
-
Wird ausgelöst, wenn die durch die
currentTime
-Eigenschaft angezeigte Zeit aktualisiert wurde. volumechange
-
Wird ausgelöst, wenn die Lautstärke geändert wurde.
waiting
-
Wird ausgelöst, wenn die Wiedergabe gestoppt wurde, weil vorübergehend Daten fehlen.
waitingforkey
-
Wird ausgelöst, wenn die Wiedergabe zuerst blockiert ist, während auf einen Schlüssel gewartet wird.
Spezifikationen
Specification |
---|
HTML Standard # htmlmediaelement |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
Referenzen
<video>
und<audio>
HTML-ElementeHTMLVideoElement
undHTMLAudioElement
Schnittstellen, abgeleitet vonHTMLMediaElement