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 benötigt werden, um grundlegende medienbezogene Fähigkeiten zu unterstützen, die für Audio und Video üblich sind.
Die HTMLVideoElement
- und HTMLAudioElement
-Elemente erben beide von diesem 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: 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 Leitfaden zum automatischen Abspielen für Medien und Web-Audio-APIs für mehr Informationen. Beachten Sie, dass Browser Anfragen zum automatischen Abspielen ignorieren können, daher sollte sichergestellt werden, dass Ihr Code nicht davon abhängig ist, dass das automatische Abspielen funktioniert.
HTMLMediaElement.buffered
Nur lesbar-
Gibt ein
TimeRanges
-Objekt zurück, das die Bereiche der Mediendatenquelle angibt, die der Browser derzeit gepuffert hat (falls vorhanden), wenn auf diebuffered
-Eigenschaft zugegriffen wird. HTMLMediaElement.controls
-
Ein boolescher Wert, der das
controls
-HTML-Attribut widerspiegelt und angibt, ob Benutzeroberflächelemente 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, wann immer der Benutzeragent seine eigene Steuerelemente zeigt. 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
Nur lesbar-
Gibt einen String mit der absoluten URL der gewählten Medienressource zurück.
HTMLMediaElement.currentTime
-
Ein double-präzisions Gleitkommawert, 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 sucht das Medium zur neuen Zeit. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.
HTMLMediaElement.defaultMuted
-
Ein boolescher Wert, der das
muted
-HTML-Attribut widerspiegelt, das 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 Status der Remote-Wiedergabe setzt oder zurückgibt, der angibt, ob das Medienelement eine Benutzeroberfläche für die Remote-Wiedergabe haben darf.
HTMLMediaElement.duration
Nur lesbar-
Ein schreibgeschützter double-präzisions Gleitkommawert, 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 ein gestreamtes Live-Medium, die Medien eines WebRTC-Anrufs oder ähnliches), ist der Wert+Infinity
. HTMLMediaElement.ended
Nur lesbar-
Gibt ein boolescher Wert zurück, der angibt, ob das Medienelement das Abspielen beendet hat.
HTMLMediaElement.error
Nur lesbar-
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, das 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 ein Satz von Schlüsseln ist, 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 der Ton stummgeschaltet ist.
true
, wenn der Ton stumm ist undfalse
andernfalls. HTMLMediaElement.networkState
Nur lesbar-
Gibt einen
unsigned short
(Aufzählung) zurück, der den aktuellen Status des Abspielens des Mediums über das Netzwerk angibt. HTMLMediaElement.paused
Nur lesbar-
Gibt ein boolescher Wert zurück, der angibt, ob das Medienelement pausiert ist.
HTMLMediaElement.playbackRate
-
Ein
double
, der angibt, mit welcher Rate das Medium abgespielt wird. HTMLMediaElement.played
Nur lesbar-
Gibt ein
TimeRanges
-Objekt zurück, das die Bereiche der Mediendatenquelle enthält, die der Browser gegebenenfalls abgespielt hat. 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 beibehalten wird. Wenn auf
false
gesetzt, passt sich die Tonhöhe an die Geschwindigkeit des Audios an. HTMLMediaElement.readyState
Nur lesbar-
Gibt einen
unsigned short
(Aufzählung) zurück, der den Bereitschaftsstatus des Mediums angibt. HTMLMediaElement.remote
Nur lesbar-
Gibt eine
RemotePlayback
-Objektinstanz zurück, die mit dem Medienelement verbunden 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 ein boolescher Wert zurück, der angibt, ob das Medium derzeit versucht, eine neue Position zu erreichen.
HTMLMediaElement.sinkId
Nur lesbar Secure context-
Gibt einen String zurück, der die eindeutige ID des Audiogeräts ist, das die Ausgabe bereitstellt, oder einen leeren String, wenn das vom Benutzeragenten voreingestellte Audiogerät 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 des mit dem
HTMLMediaElement
verbundenen Mediums dient odernull
, wenn nicht zugewiesen. HTMLMediaElement.textTracks
Nur lesbar-
Gibt ein
TextTrackList
-Objekt zurück, das die Liste der im Element enthaltenenTextTrack
-Objekte enthält. HTMLMediaElement.videoTracks
Nur lesbar-
Gibt ein
VideoTrackList
-Objekt zurück, das die im Element enthaltene Liste derVideoTrack
-Objekte enthält. HTMLMediaElement.volume
-
Ein
double
, das die Lautstärke des Audios angibt, von 0,0 (stumm) 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 zugewiesenen Mediencontroller darstellt, odernull
, wenn keiner zugewiesen ist. HTMLMediaElement.mediaGroup
Veraltet Nicht standardisiert-
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 sich einen gemeinsamenMediaController
. HTMLMediaElement.mozAudioCaptured
Nur lesbar Nicht standardisiert Veraltet-
Gibt ein boolescher Wert zurück. Bezieht sich auf die Erfassung des Audiostreams.
HTMLMediaElement.mozFragmentEnd
Nicht standardisiert Veraltet-
Ein
double
, das Zugriff auf die Fragmentendzeit bietet, wenn das Medienelement eine Fragment-URI fürcurrentSrc
hat, andernfalls ist es gleich der Mediedauer.
Instanzmethoden
Dieses Interface erbt auch Methoden von seinen Vorfahren HTMLElement
, Element
, Node
und EventTarget
.
HTMLMediaElement.addTextTrack()
-
Fügt ein neues
TextTrack
-Objekt (wie ein Track für Untertitel) zu einem Medienelement hinzu. Dies ist nur eine programmatische 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-Mediatype spezifiziert (möglicherweise mit dem
codecs
-Parameter), gibtcanPlayType()
den Stringprobably
zurück, wenn das Medium abgespielt werden sollte,maybe
, wenn es nicht genug Informationen gibt, um zu bestimmen, 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 durch das
src
-Attribut oder das<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 Frame im Medium. Diese nicht standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien mit benutzerdefinierter Geschwindigkeit manuell zu steuern oder sich frameweise durch das Medium zu bewegen, um Filterung oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys()
Secure context-
Gibt
Promise
zurück. Setzt dieMediaKeys
-Schlüssel fest, die während der Wiedergabe zur Entschlüsselung von Medien verwendet werden. HTMLMediaElement.setSinkId()
Secure context-
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 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-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 abgespielten Medienressource als{Schlüssel: Wert}
-Paare darstellen. Jedes Mal, wenn die Methode aufgerufen wird, wird eine separate Kopie der Daten zurückgegeben. Diese Methode muss aufgerufen werden, nachdem dasloadedmetadata
Ereignis ausgelöst wurde.
Events
Erbt Ereignisse von seinem Elternteil, HTMLElement
.
Hören Sie auf diese Ereignisse mit addEventListener()
oder indem Sie einen Event-Listener auf die oneventname
-Eigenschaft dieses Interfaces zuweisen.
abort
-
Ausgelöst, wenn die Ressource nicht vollständig geladen wurde, aber nicht als Ergebnis eines Fehlers.
canplay
-
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 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 zum Ende abzuspielen, ohne für weiteres Puffern von Inhalten anhalten zu müssen.
durationchange
-
Ausgelöst, wenn die Eigenschaft "Dauer" 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 im Medium gefunden werden, die darauf hinweisen, dass es verschlüsselt ist.
ended
-
Ausgelöst, wenn die Wiedergabe stoppt, weil das Ende des Mediums (z. B.
<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 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 Anfrage zum Pausieren der Wiedergabe bearbeitet wurde und die Aktivität ihren pausierten Zustand erreicht hat, meist tritt dies auf, 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 bereit ist, nach einer Pause oder Verzögerung aufgrund von Datenmangel zu starten.
progress
-
Wird periodisch ausgelöst, während der Browser eine Ressource lädt.
ratechange
-
Ausgelöst, wenn sich die Wiedergabegeschwindigkeit geändert hat.
seeked
-
Ausgelöst, wenn eine Suchoperation abgeschlossen ist.
seeking
-
Ausgelöst, wenn eine Suchoperation beginnt.
stalled
-
Ausgelöst, wenn der Benutzeragent versucht, Mediendaten zu laden, aber unerwarteterweise keine Daten kommen.
suspend
-
Ausgelöst, wenn das Laden von Mediendaten ausgesetzt wurde.
timeupdate
-
Ausgelöst, wenn die Zeit, die durch die
currentTime
-Eigenschaft angegeben wird, aktualisiert wurde. volumechange
-
Ausgelöst, wenn sich die Lautstärke geändert hat.
waiting
-
Ausgelöst, wenn die Wiedergabe aufgrund eines vorübergehenden Mangels an Daten gestoppt wurde.
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