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 Eigenschaften und Methoden, die benötigt werden, um grundlegende medienbezogene Fähigkeiten zu unterstützen, die bei Audio und Video üblich sind.
Die HTMLVideoElement
und HTMLAudioElement
Elemente erben beide dieses Interface.
Instanzeigenschaften
Dieses Interface erbt auch Eigenschaften von seinen Vorfahren HTMLElement
, Element
, Node
, und EventTarget
.
HTMLMediaElement.audioTracks
-
Eine
AudioTrackList
, die dieAudioTrack
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 verfügbar sind, um dies ohne Unterbrechung zu tun.Hinweis: Audio automatisch abzuspielen, 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 Leitfaden zu Autoplay für Medien und Web Audio APIs für mehr Informationen. Beachten Sie, dass Browser Autoplay-Anforderungen ignorieren könnten, 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 (falls vorhanden) gepuffert hat, zu dem Zeitpunkt, zu dem diebuffered
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 Steuerungselemente auf dem Medienelement angezeigt werden sollen, wann immer der Benutzeragent seine eigene Kontrolle anzeigt. DieDOMTokenList
nimmt einen 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
Schreibgeschützt-
Gibt einen String mit der absoluten URL der gewählten Medienressource zurück.
HTMLMediaElement.currentTime
-
Ein Gleitkommawert doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn die Medien noch nicht gestartet wurden und nicht gesucht wurden, 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 Zeitleiste 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 soll. HTMLMediaElement.defaultPlaybackRate
-
Ein
double
, der die Standardwiedergaberate für das Medium angibt. HTMLMediaElement.disableRemotePlayback
-
Ein boolescher Wert, der den Fernwiedergabe-Zustand festlegt oder zurückgibt und angibt, ob das Medienelement eine Fernwiedergabe-Oberfläche haben darf.
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 gestreamte Live-Medien, ein WebRTC-Anruf-Medium oder ähnliches), ist der Wert+Infinity
. HTMLMediaElement.ended
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob das Medienelement die Wiedergabe beendet hat.
HTMLMediaElement.error
Schreibgeschützt-
Gibt ein
MediaError
Objekt für den letzten 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 anfangen soll, wenn es das Ende erreicht. HTMLMediaElement.mediaKeys
Schreibgeschützt Sicherer Kontext-
Gibt ein
MediaKeys
Objekt zurück, das einen Satz von Schlüsseln enthält, den 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
, wenn nicht. HTMLMediaElement.networkState
Schreibgeschützt-
Gibt einen
unsigned short
(Enumeration) zurück, der den aktuellen Zustand der Abfrage 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 Rate angibt, mit der das Medium wiedergegeben 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, falls vorhanden, vorab geladen werden sollen. 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 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 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 eine neue Position ansteuert.
HTMLMediaElement.sinkId
Schreibgeschützt Sicherer Kontext-
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 zu verwendenden Medienressource enthält. HTMLMediaElement.srcObject
-
Ein Objekt, das als Quelle der mit dem
HTMLMediaElement
verbundenen Medien dient, odernull
, wenn es nicht zugewiesen ist. HTMLMediaElement.textTracks
Schreibgeschützt-
Gibt ein
TextTrackList
Objekt zurück, das die Liste derTextTrack
Objekte enthält, die im Element enthalten sind. HTMLMediaElement.videoTracks
Schreibgeschützt-
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 von 0.0 (stumm) 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, 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 einen gemeinsamenMediaController
. HTMLMediaElement.mozAudioCaptured
Schreibgeschützt Nicht standardisiert Veraltet-
Gibt einen booleschen Wert zurück. Im Zusammenhang mit Audio-Stream-Aufnahme.
HTMLMediaElement.mozFragmentEnd
Nicht standardisiert Veraltet-
Ein
double
, das den Zugriff auf das Fragment-Ende ermöglicht, wenn das Medienelement eine Fragment-URI fürcurrentSrc
hat, andernfalls entspricht es der Mediendauer.
Instanzmethoden
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 eine programmgesteuerte Schnittstelle und beeinflusst nicht das DOM. HTMLMediaElement.captureStream()
-
Gibt
MediaStream
zurück, erfasst einen Stream des Medieninhalts. HTMLMediaElement.canPlayType()
-
Angenommen, ein String, der einen MIME-Medientyp angibt (möglicherweise mit dem
codecs
Parameter eingeschlossen), gibtcanPlayType()
den Stringprobably
zurück, wenn das Medium abspielbar sein sollte,maybe
, wenn nicht genug Informationen vorliegen, um festzustellen, ob das Medium abgespielt werden kann, oder einen leeren String, wenn das Medium nicht abgespielt werden kann. HTMLMediaElement.fastSeek()
-
Sucht schnell zu der angegebenen Zeit mit geringer Präzision.
HTMLMediaElement.load()
-
Setzt das Medium an den Anfang zurück und wählt die beste verfügbare Quelle aus den mit dem
src
Attribut oder dem<source>
Element bereitgestellten Quellen aus. HTMLMediaElement.pause()
-
Pausiert die Medienwiedergabe.
HTMLMediaElement.play()
-
Beginnt die Wiedergabe des Mediums.
HTMLMediaElement.seekToNextFrame()
Veraltet Nicht standardisiert-
Sucht zum nächsten Bild im Medium. Diese nicht-standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien mit einer benutzerdefinierten Geschwindigkeit manuell zu steuern oder durch die Medien Bild für Bild zu gehen, um Filterung oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys()
Sicherer Kontext-
Gibt ein
Promise
zurück. Setzt dieMediaKeys
Schlüssel, die bei der 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äfigierte Äquivalent zu
HTMLMediaElement.captureStream()
. Siehe dessen 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 von der abgespielten 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 demloadedmetadata
Ereignis aufgerufen werden.
Ereignisse
Erbt Ereignisse von seinem Elternteil, HTMLElement
.
Hören Sie auf diese Ereignisse mit addEventListener()
oder indem Sie einen Ereignis-Listener der oneventname
Eigenschaft dieses Interface zuordnen.
abort
-
Ausgelöst, wenn die Ressource nicht vollständig geladen wurde, jedoch nicht als Ergebnis eines Fehlers.
canplay
-
Ausgelöst, wenn der Benutzeragent das Medium abspielen kann, aber schätzt, dass nicht genug Daten geladen wurden, um das Medium bis zu seinem Ende zu spielen, ohne für weiteres Puffern von Inhalten anhalten zu müssen.
canplaythrough
-
Ausgelöst, wenn der Benutzeragent das Medium abspielen kann und schätzt, dass genug Daten geladen wurden, um das Medium bis zu seinem Ende zu spielen, ohne für weiteres Puffern von Inhalten anhalten zu müssen.
durationchange
-
Ausgelöst, wenn die
duration
-Eigenschaft aktualisiert wurde. emptied
-
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
-
Ausgelöst, wenn Initialisierungsdaten in den Medien gefunden werden, die darauf hinweisen, dass die Medien verschlüsselt sind.
ended
-
Ausgelöst, wenn die Wiedergabe stoppt, wenn das Ende des Mediums (
<audio>
oder<video>
) erreicht ist oder weil keine weiteren Daten verfügbar sind. error
-
Ausgelöst, wenn die Ressource aufgrund eines Fehlers nicht geladen werden konnte.
loadeddata
-
Ausgelöst, wenn der erste Frame des Mediums fertig geladen ist.
loadedmetadata
-
Ausgelöst, wenn die Metadaten geladen wurden.
loadstart
-
Ausgelöst, wenn der Browser begonnen hat, eine Ressource zu laden.
pause
-
Ausgelöst, wenn eine Anforderung zum Pausieren der Wiedergabe bearbeitet wird und die Aktivität ihren Pausenzustand erreicht hat, was am häufigsten auftritt, wenn die
HTMLMediaElement.pause()
Methode des Mediums aufgerufen wird. play
-
Ausgelöst, wenn die
paused
Eigenschaft vontrue
auffalse
geändert wird, als Ergebnis derHTMLMediaElement.play()
Methode oder desautoplay
-Attributs. playing
-
Ausgelöst, wenn die Wiedergabe nach dem Pausieren oder Verzögern aufgrund von Datenmangel bereit ist zu starten.
progress
-
Wird regelmäßig ausgelöst, während der Browser eine Ressource lädt.
ratechange
-
Ausgelöst, wenn sich die Wiedergaberate ändert.
seeked
-
Ausgelöst, wenn ein Suchvorgang abgeschlossen ist.
seeking
-
Ausgelöst, wenn ein Suchvorgang beginnt.
stalled
-
Ausgelöst, wenn der Benutzeragent versucht, Mediendaten abzurufen, aber unerwarteterweise keine Daten kommen.
suspend
-
Ausgelöst, wenn das Laden der Mediendaten angehalten wurde.
timeupdate
-
Ausgelöst, wenn die durch die
currentTime
Eigenschaft angegebene Zeit aktualisiert wurde. volumechange
-
Ausgelöst, wenn sich die Lautstärke verändert hat.
waiting
-
Ausgelöst, wenn die Wiedergabe aufgrund eines vorübergehenden Datenmangels gestoppt hat.
waitingforkey
-
Ausgelöst, wenn die Wiedergabe zuerst blockiert wird, während auf einen Schlüssel gewartet wird.
Spezifikationen
Specification |
---|
HTML # htmlmediaelement |
Browser-Kompatibilität
Siehe auch
Referenzen
<video>
und<audio>
HTML-ElementeHTMLVideoElement
undHTMLAudioElement
Interfaces, abgeleitet vonHTMLMediaElement