HTMLMediaElement

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 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 Autoplay-Leitfaden für Medien und Web Audio APIs für mehr 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 Schreibgeschützt

Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Medienquelle anzeigt, die der Browser aktuell gepuffert hat (falls vorhanden), wenn auf die buffered-Eigenschaft zugegriffen wird.

HTMLMediaElement.controls

Ein boolescher Wert, der das controls-HTML-Attribut widerspiegelt und angibt, ob Benutzeroberflächen-Elemente 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, wann immer der Benutzeragent seine eigenen Steuerelemente zeigt. Die DOMTokenList nimmt einen oder mehrere der drei möglichen Werte an: nodownload, nofullscreen und noremoteplayback.

HTMLMediaElement.crossOrigin

Ein Zeichenfolgenwert, der die CORS-Einstellung für dieses Medienelement angibt.

HTMLMediaElement.currentSrc Schreibgeschützt

Gibt eine Zeichenfolge mit der absoluten URL der ausgewählten Medienressource zurück.

HTMLMediaElement.currentTime

Ein Wert mit doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn die Medien nicht gestartet wurden und keine Suche stattgefunden hat, ist dieser Wert die anfängliche Wiedergabezeit der Medien. Durch das Setzen dieses Wertes wird das Medium an die neue Zeit gesucht. Die Zeit wird relativ zur Zeitleiste der Medien angegeben.

HTMLMediaElement.defaultMuted

Ein boolescher Wert, der das muted-HTML-Attribut widerspiegelt, das angibt, ob der Audioausgang des Medienelements standardmäßig stummgeschaltet sein soll.

HTMLMediaElement.defaultPlaybackRate

Ein double, der die Standard-Wiedergaberate für die Medien angibt.

HTMLMediaElement.disableRemotePlayback

Ein boolescher Wert, der den Zustand des Remote-Playbacks setzt oder zurückgibt und angibt, ob das Medienelement eine Remote-Wiedergabe-Benutzeroberfläche 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 das Medium eine unbestimmte Länge hat (wie gestreamte Live-Medien, Medien eines WebRTC-Anrufs oder ähnliche), 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 oder null, wenn es keinen Fehler gegeben hat.

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 Schreibgeschützt Sicherer Kontext

Gibt ein MediaKeys-Objekt zurück, das einen Satz von Schlüsseln darstellt, 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 Audio stummgeschaltet ist. true wenn das Audio stummgeschaltet ist und false ansonsten.

HTMLMediaElement.networkState Schreibgeschützt

Gibt ein unsigned short (Enumeration) zurück, das den aktuellen Zustand des Medienabrufs über das Netzwerk angibt.

HTMLMediaElement.paused Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das Medienelement angehalten 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 wiedergegeben hat, falls vorhanden.

HTMLMediaElement.preload

Eine Zeichenfolge, die 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 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 eine Instanz des RemotePlayback-Objekts zurück, das mit dem Medienelement verknüpft 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 dabei ist, zu einer neuen Position zu suchen.

HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext

Gibt eine Zeichenfolge zurück, die die eindeutige ID des Audiogeräts enthält, das die Ausgabe liefert, oder eine leere Zeichenfolge, wenn das Standard-Audiogerät des Benutzeragenten verwendet wird.

HTMLMediaElement.src

Eine Zeichenfolge, die das src-HTML-Attribut widerspiegelt und die URL einer Medienressource enthält, die verwendet werden soll.

HTMLMediaElement.srcObject

Ein Objekt, das als Quelle des mit dem HTMLMediaElement verbundenen Medienelements 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, das die Lautstärke des Audios angibt, von 0.0 (stumm) bis 1.0 (am lautesten).

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 Medien-Controller repräsentiert oder null, wenn keiner zugewiesen ist.

HTMLMediaElement.mediaGroup Veraltet Nicht standardisiert

Eine Zeichenfolge, die das mediagroup-HTML-Attribut widerspiegelt und angibt, zu welcher Gruppe von Elementen 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. Bezieht sich auf die Audio-Stream-Erfassung.

HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet

Ein double, der Zugriff auf die Fragment-Endzeit 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 (wie z.B. eine Spur für Untertitel) zu einem Medienelement hinzu. Dies ist eine programmgesteuerte Schnittstelle und hat keinen Einfluss auf das DOM.

HTMLMediaElement.captureStream()

Gibt MediaStream zurück, erfasst einen Stream des Medieninhalts.

HTMLMediaElement.canPlayType()

Bei Angabe eines Strings, der einen MIME-Medientyp beschreibt (möglicherweise mit dem codecs parameter inkludiert), gibt canPlayType() den String probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn es nicht genügend 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 niedriger Präzision.

HTMLMediaElement.load()

Setzt die Medien auf den Anfang zurück und wählt die beste verfügbare Quelle aus den bereitgestellten Quellen mithilfe des src-Attributs oder des <source>-Elements aus.

HTMLMediaElement.pause()

Unterbricht die Medienwiedergabe.

HTMLMediaElement.play()

Beginnt die Wiedergabe der Medien.

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() Sicherer Kontext

Gibt Promise zurück. Setzt die MediaKeys-Schlüssel, die beim Entschlüsseln von Medien während der Wiedergabe verwendet werden sollen.

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.

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 zu HTMLMediaElement.captureStream(). Siehe die 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 aus der abspielenden Medienressource als {key: value}-Paare repräsentieren. Eine separate Kopie der Daten wird jedes Mal zurückgegeben, wenn die Methode aufgerufen wird. Diese Methode muss aufgerufen werden, nachdem das loadedmetadata-Event ausgelöst wurde.

Erbt Ereignisse von seinem Elternteil, HTMLElement.

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuweisen eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces ab.

abort

Wird ausgelöst, wenn die Ressource nicht vollständig geladen wurde, jedoch nicht als Ergebnis eines Fehlers.

canplay

Wird ausgelöst, wenn der Benutzeragent das Medium abspielen kann, jedoch schätzt, dass nicht ausreichend Daten geladen wurden, um die Medien bis zum Ende abzuspielen, ohne für weiteres Puffern des Inhalts anhalten zu müssen.

canplaythrough

Wird ausgelöst, wenn der Benutzeragent das Medium abspielen kann und schätzt, dass genügend Daten geladen wurden, um die Medien bis zum Ende abzuspielen, ohne für weiteres Puffern des Inhalts anhalten zu müssen.

durationchange

Wird ausgelöst, wenn die duration-Eigenschaft 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 anzeigen, dass die Medien verschlüsselt sind.

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 der Medien fertig geladen wurde.

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 zum Pausieren der Wiedergabe bearbeitet wird und die Aktivität in den Pausenzustand wechselt, was am häufigsten auftritt, wenn die Methode HTMLMediaElement.pause() des Mediums aufgerufen wird.

play

Wird ausgelöst, wenn die paused-Eigenschaft von true auf false geändert wird, als Ergebnis der Methode HTMLMediaElement.play() oder des autoplay-Attributs.

playing

Wird ausgelöst, wenn die Wiedergabe bereit ist zu starten, nachdem sie angehalten oder wegen Datenmangels verzögert wurde.

progress

Wird periodisch 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 ein Suchvorgang abgeschlossen ist.

seeking

Wird ausgelöst, wenn ein Suchvorgang beginnt.

stalled

Wird ausgelöst, wenn der Benutzeragent versucht, Mediendaten abzurufen, aber Daten unerwartet nicht bereitgestellt werden.

suspend

Wird ausgelöst, wenn das Laden der Mediadaten unterbrochen wurde.

timeupdate

Wird ausgelöst, wenn die Zeit, die durch die currentTime-Eigenschaft angegeben ist, 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 keine Daten vorhanden sind.

waitingforkey

Wird ausgelöst, wenn die Wiedergabe zuerst blockiert wird, während auf einen Schlüssel gewartet wird.

• <video> und <audio> HTML-Elemente
• HTMLVideoElement und HTMLAudioElement-Schnittstellen, abgeleitet von HTMLMediaElement

• Webmedientechnologien
• Lernbereich: HTML Video und Audio
• Medientypen- und Format-Leitfaden
• Umgang mit Medienunterstützungsproblemen in Webinhalten