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.
Instanz-Eigenschaften
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 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 diebuffered
-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. 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 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 odernull
, 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 esnull
sein. HTMLMediaElement.muted
-
Ein boolescher Wert, der bestimmt, ob das Audio stummgeschaltet ist.
true
, wenn das Audio stummgeschaltet ist, andernfallsfalse
. 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 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 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 odernull
, 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 gemeinsamenMediaController
. 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ürcurrentSrc
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, gibtcanPlayType()
den Stringprobably
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 dieMediaKeys
-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 desloadedmetadata
-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 vontrue
auffalse
geändert wird, infolge derHTMLMediaElement.play()
-Methode oder desautoplay
-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
Siehe auch
Referenzen
<video>
und<audio>
HTML-ElementeHTMLVideoElement
undHTMLAudioElement
Schnittstellen, abgeleitet vonHTMLMediaElement