Baseline Widely available *
Das HTMLMediaElement
Interface erweitert HTMLElement
um die Eigenschaften und Methoden, die zur Unterstützung grundlegender medienbezogener Funktionen erforderlich sind, die für Audio und Video üblich sind.
Die Elemente HTMLVideoElement
und HTMLAudioElement
erben beide dieses Interface.
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 autoplay
HTML-Attribut widerspiegelt und angibt, ob die Wiedergabe automatisch beginnen soll, sobald genügend Medien vorhanden sind, um dies ohne Unterbrechung zu tun.
Hinweis: Das automatische Abspielen von Audio, wenn der Benutzer es nicht erwartet oder wünscht, ist ein schlechtes Benutzererlebnis und sollte in den meisten Fällen vermieden werden, obwohl es Ausnahmen gibt. Weitere Informationen finden Sie im Autoplay-Leitfaden für Medien- und Web-Audio-APIs. Beachten Sie, dass Browser Autoplay-Anfragen möglicherweise ignorieren. 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 aktuell gepuffert hat (falls vorhanden), wenn die buffered
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 Steuerelemente auf dem Medienelement angezeigt werden sollen, wenn der Benutzeragent 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 gewählten Medienressource zurück.
HTMLMediaElement.currentTime
Ein Wert mit doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn die Medien nicht gestartet und nicht gesucht wurden, entspricht dieser Wert der anfänglichen Wiedergabezeit der Medien. Das Setzen dieses Wertes sucht die Medien zu der neuen Zeit. Die Zeit wird relativ zur Zeitleiste der Medien angegeben.
HTMLMediaElement.defaultMuted
Ein boolescher Wert, der das muted
HTML-Attribut widerspiegelt und angibt, ob die Audioausgabe des Medienelements standardmäÃig stummgeschaltet sein soll.
HTMLMediaElement.defaultPlaybackRate
Ein double
, der die Standardwiedergaberate für die Medien angibt.
HTMLMediaElement.disableRemotePlayback
Ein boolescher Wert, der den Zustand der Fernwiedergabe festlegt oder zurückgibt und angibt, ob das Medienelement eine Benutzeroberfläche für die Fernwiedergabe haben darf.
HTMLMediaElement.duration
Schreibgeschützt
Ein schreibgeschützter Wert mit doppelter Genauigkeit, der die Gesamtdauer der Medien in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, ist der zurückgegebene Wert NaN
. Wenn die Medien von unbestimmter Länge sind (z. B. gestreamte Live-Medien, die Medien eines WebRTC-Anrufs oder ähnliches), ist der Wert Infinity
.
HTMLMediaElement.ended
Schreibgeschützt
Gibt einen booleschen Wert zurück, der anzeigt, ob das Medienelement das Abspielen beendet hat.
HTMLMediaElement.error
Schreibgeschützt
Gibt ein MediaError
Objekt für den letzten Fehler zurück oder null
, wenn kein Fehler aufgetreten ist.
HTMLMediaElement.loop
Ein boolescher Wert, der das loop
HTML-Attribut widerspiegelt und angibt, ob das Medienelement neu starten soll, wenn es das Ende erreicht.
HTMLMediaElement.mediaKeys
Schreibgeschützt Sicherer Kontext
Gibt ein MediaKeys
Objekt zurück, das ein Satz von Schlüsseln ist, den 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 der Ton stummgeschaltet ist. true
, wenn der Ton stummgeschaltet ist, andernfalls false
.
HTMLMediaElement.networkState
Schreibgeschützt
Gibt ein unsigned short
(Enumeration) zurück, das den aktuellen Zustand des Abrufens der Medien über das Netzwerk angibt.
HTMLMediaElement.paused
Schreibgeschützt
Gibt einen booleschen Wert zurück, der anzeigt, ob das Medienelement angehalten ist.
HTMLMediaElement.playbackRate
Ein double
, der die Wiedergabegeschwindigkeit der Medien angibt.
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 vorgeladen 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 der Geschwindigkeit des Audios an.
HTMLMediaElement.readyState
Schreibgeschützt
Gibt ein unsigned short
(Enumeration) zurück, das den Bereitschaftszustand der Medien 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 anzeigt, ob die Medien dabei sind, an eine neue Position zu springen.
HTMLMediaElement.sinkId
Schreibgeschützt Sicherer Kontext
Gibt einen String zurück, der die eindeutige ID des Audiogeräts angibt, das eine 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, oder null
, wenn nicht zugewiesen.
HTMLMediaElement.textTracks
Schreibgeschützt
Gibt ein TextTrackList
Objekt zurück, das die Liste der im Element enthaltenen TextTrack
Objekte enthält.
HTMLMediaElement.videoTracks
Schreibgeschützt
Gibt ein VideoTrackList
Objekt zurück, das die Liste der im Element enthaltenen VideoTrack
Objekte enthält.
HTMLMediaElement.volume
Ein double
, der die Lautstärke angibt, von 0.0 (stumm) bis 1.0 (am lautesten).
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, oder null
, wenn keiner zugewiesen ist.
HTMLMediaElement.mediaGroup
Veraltet Nicht standardisiert
Ein String, der das mediagroup
HTML-Attribut widerspiegelt und den Namen der Gruppe von Elementen angibt, zu der es gehört. Eine Gruppe von Medienelementen teilt sich einen gemeinsamen MediaController
.
HTMLMediaElement.mozAudioCaptured
Schreibgeschützt Nicht standardisiert Veraltet
Gibt einen booleschen Wert zurück. Bezogen auf die Erfassung des Audiostreams.
HTMLMediaElement.mozFragmentEnd
Nicht standardisiert Veraltet
Ein double
, das Zugriff auf das Fragment-Ende bietet, wenn das Medienelement eine Fragment-URI für currentSrc
hat, andernfalls ist es gleich der Mediendauer.
Dieses Interface erbt auch Methoden von seinen Vorfahren HTMLElement
, Element
, Node
und EventTarget
.
HTMLMediaElement.addTextTrack()
Fügt ein neues TextTrack
Objekt (z. B. eine Spur für Untertitel) einem Medienelement hinzu. Dies ist eine rein programmatische Schnittstelle und hat keinen Einfluss auf das DOM.
HTMLMediaElement.captureStream()
Gibt MediaStream
zurück und erfasst einen Stream des Medieninhalts.
HTMLMediaElement.canPlayType()
Gegeben ein String, der einen MIME-Medientyp angibt (möglicherweise mit dem codecs
Parameter), gibt canPlayType()
den String probably
zurück, wenn die Medien abspielbar sein sollten, maybe
, wenn nicht genügend Informationen vorliegen, um zu bestimmen, ob die Medien abgespielt werden können oder nicht, oder einen leeren String, wenn die Medien nicht abgespielt werden können.
HTMLMediaElement.fastSeek()
Springt schnell zu der angegebenen Zeit mit geringer Präzision.
HTMLMediaElement.load()
Setzt die Medien an den Anfang zurück und wählt die beste verfügbare Quelle aus den mittels des src
Attributs oder des <source>
Elements bereitgestellten Quellen aus.
HTMLMediaElement.pause()
Pausiert die Medienwiedergabe.
HTMLMediaElement.play()
Beginnt die Wiedergabe der Medien.
HTMLMediaElement.seekToNextFrame()
Veraltet Nicht standardisiert
Springt zum nächsten Frame in den Medien. Diese nicht standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien mit benutzerdefinierter Geschwindigkeit manuell zu steuern oder frameweise durch die Medien zu gehen, um Filterungen oder andere Vorgänge durchzuführen.
HTMLMediaElement.setMediaKeys()
Sicherer Kontext
Gibt Promise
zurück. Setzt die MediaKeys
Schlüssel, die bei der Entschlüsselung von Medien während der Wiedergabe zu verwenden sind.
HTMLMediaElement.setSinkId()
Sicherer Kontext
Setzt die ID des Audiogeräts für die Ausgabe und gibt ein Promise
zurück. Dies funktioniert nur, wenn die Anwendung berechtigt ist, das angegebene Gerät zu verwenden.
Diese Methoden sind veraltet und sollten nicht verwendet werden, selbst wenn ein Browser sie noch unterstützt.
HTMLMediaElement.mozCaptureStream()
Nicht standardisiert
Das Firefox-spezifische Gegenstück von HTMLMediaElement.captureStream()
. Siehe deren Browser-Kompatibilität für Details.
HTMLMediaElement.mozCaptureStreamUntilEnded()
Nicht standardisiert Veraltet
[Beschreibung einfügen]
HTMLMediaElement.mozGetMetadata()
Nicht standardisiert Veraltet
Gibt Object
zurück, das Eigenschaften enthält, die Metadaten der abspielenden 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 dem loadedmetadata
Ereignis aufgerufen werden.
Erbt Ereignisse von seinem Vorfahren HTMLElement
.
Diese Ereignisse können mit addEventListener()
überwacht werden oder indem ein Ereignislistener der oneventname
Eigenschaft dieses Interfaces zugewiesen wird.
abort
Wird ausgelöst, wenn die Ressource nicht vollständig geladen wurde, aber nicht aufgrund eines Fehlers.
canplay
Wird ausgelöst, wenn der Benutzeragent die Medien abspielen kann, aber schätzt, dass nicht genügend Daten geladen wurden, um die Medien bis zum Ende abzuspielen, ohne für weiteres Puffern von Inhalten anzuhalten.
canplaythrough
Wird ausgelöst, wenn der Benutzeragent die Medien abspielen kann und schätzt, dass genügend Daten geladen wurden, um die Medien bis zum Ende abzuspielen, ohne für weiteres Puffern von Inhalten anzuhalten.
durationchange
Wird ausgelöst, wenn die Eigenschaft duration
aktualisiert wurde.
emptied
Wird ausgelöst, wenn die Medien leer geworden sind; zum Beispiel, wenn die Medien bereits geladen (oder teilweise geladen) wurden und die Methode HTMLMediaElement.load()
aufgerufen wird, um sie neu zu laden.
encrypted
Wird ausgelöst, wenn Initialisierungsdaten in den Medien gefunden werden, die darauf hinweisen, dass die Medien verschlüsselt sind.
ended
Wird ausgelöst, wenn die Wiedergabe stoppt, wenn das Ende der Medien (<audio>
oder <video>
) erreicht wird 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 fertig 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 Anforderung zum Anhalten der Wiedergabe bearbeitet wird und die Aktivität ihren pausierten Zustand erreicht hat, was meist auftritt, wenn die Methode HTMLMediaElement.pause()
des Mediums aufgerufen wird.
play
Wird ausgelöst, wenn die Eigenschaft paused
von true
auf false
geändert wird, als Ergebnis der Methode HTMLMediaElement.play()
oder des autoplay
Attributs.
playing
Wird ausgelöst, wenn die Wiedergabe nach einer Pause oder einer Verzögerung aufgrund fehlender Daten startbereit ist.
progress
Wird regelmäÃig ausgelöst, während der Browser eine Ressource lädt.
ratechange
Wird ausgelöst, wenn die Wiedergabegeschwindigkeit geändert wurde.
seeked
Wird ausgelöst, wenn eine Suchoperation abgeschlossen ist.
seeking
Wird ausgelöst, wenn eine Suchoperation beginnt.
stalled
Wird ausgelöst, wenn der Benutzeragent versucht, Mediendaten abzurufen, aber keine Daten unerwartet verfügbar sind.
suspend
Wird ausgelöst, wenn das Laden von Mediendaten ausgesetzt 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 gestoppt wurde aufgrund eines vorübergehenden Mangels an Daten.
waitingforkey
Wird ausgelöst, wenn die Wiedergabe erstmals blockiert ist, während auf einen Schlüssel gewartet wird.
<video>
und <audio>
HTML ElementeHTMLVideoElement
und HTMLAudioElement
Interfaces, abgeleitet von HTMLMediaElement
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4