HTMLMediaElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

* Some parts of this feature may have varying levels of support.

Das HTMLMediaElement Interface erweitert das HTMLElement um die Eigenschaften und Methoden, die erforderlich sind, um grundlegende medienbezogene Fähigkeiten zu unterstützen, die für Audio und Video gemeinsam sind.

Die Elemente HTMLVideoElement und HTMLAudioElement erben beide dieses Interface.

Instanzeigenschaften

Dieses Interface erbt auch Eigenschaften von seinen Vorfahren HTMLElement, Element, Node und EventTarget.

HTMLMediaElement.audioTracks Schreibgeschützt: Ein AudioTrackList Objekt, das die AudioTrack Objekte im Element auflistet.
HTMLMediaElement.autoplay: Ein boolescher Wert, der das HTML-Attribut autoplay 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 Nutzer es nicht erwartet oder wünscht, ist eine schlechte Benutzererfahrung und sollte in den meisten Fällen vermieden werden, obwohl es Ausnahmen gibt. Weitere Informationen finden Sie im Leitfaden zur automatischen Wiedergabe von Medien und Web Audio APIs. Beachten Sie, dass Browser Autoplay-Anfragen ignorieren können, sodass Sie sicherstellen sollten, dass Ihr Code nicht darauf angewiesen ist, dass Autoplay funktioniert.
HTMLMediaElement.buffered Schreibgeschützt: Gibt ein TimeRanges Objekt zurück, das die Bereiche der Medienquelle angibt, die der Browser gepuffert hat (falls vorhanden), wenn auf die buffered Eigenschaft zugegriffen wird.
HTMLMediaElement.controls: Ein Boolean, der das HTML-Attribut controls widerspiegelt und angibt, ob Benutzeroberflächenelemente zur Steuerung der Ressource angezeigt werden sollen.
HTMLMediaElement.controlsList: Gibt eine DOMTokenList zurück, die dem User-Agent hilft, auszuwählen, welche Steuerungselemente auf dem Medienelement angezeigt werden sollen, wann immer der User-Agent sein eigenes Set von Steuerungen anzeigt. Die DOMTokenList kann einen oder mehrere der drei möglichen Werte haben: 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 doppelt präziser Fließkommertyp, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium nicht zu spielen begonnen hat und nicht gesucht wurde, ist dieser Wert die anfängliche Wiedergabezeit des Mediums. Wenn Sie diesen Wert festlegen, sucht das Medium zur neuen Zeit. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.
HTMLMediaElement.defaultMuted: Ein Boolean, der das HTML-Attribut muted widerspiegelt und angibt, ob die Audioausgabe des Medienelements standardmäßig stummgeschaltet sein soll.
HTMLMediaElement.defaultPlaybackRate: Ein double, der die Standard-Wiedergabegeschwindigkeit für das Medium angibt.
HTMLMediaElement.disableRemotePlayback: Ein Boolean, der den Zustand der Remote-Wiedergabe festlegt oder zurückgibt, was angibt, ob das Medienelement eine Benutzeroberfläche für die Remote-Wiedergabe besitzen darf.
HTMLMediaElement.duration Schreibgeschützt: Ein schreibgeschützter, doppelt präziser Fließkommawert, 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 gestreamtes Live-Medium, eine WebRTC-Call-Medienquelle oder ähnliches), ist der Wert Infinity.
HTMLMediaElement.ended Schreibgeschützt: Gibt einen Boolean zurück, der angibt, ob das Medienelement mit der Wiedergabe fertig ist.
HTMLMediaElement.error Schreibgeschützt: Gibt ein MediaError Objekt für den letzten Fehler zurück, oder null, wenn kein Fehler vorlag.
HTMLMediaElement.loop: Ein Boolean, der das HTML-Attribut loop widerspiegelt, was 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 einen 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 Boolean, der bestimmt, ob der Ton stummgeschaltet ist. true wenn der Ton stumm ist, und false andernfalls.
HTMLMediaElement.networkState Schreibgeschützt: Gibt einen unsigned short (Enumeration) zurück, der den aktuellen Zustand des Abrufens der Medien über das Netzwerk angibt.
HTMLMediaElement.paused Schreibgeschützt: Gibt einen Boolean 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 Bereiche der Medienquelle enthält, die der Browser abgespielt hat, falls vorhanden.
HTMLMediaElement.preload: Ein String, der das HTML-Attribut preload 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 erhalten bleibt. Wenn false gesetzt ist, wird die Tonhöhe an die Geschwindigkeit des Audios angepasst.
HTMLMediaElement.readyState Schreibgeschützt: Gibt einen unsigned short (Enumeration) zurück, der den Bereitschaftszustand des Mediums angibt.
HTMLMediaElement.remote Schreibgeschützt: Gibt ein RemotePlayback Objektinstanz zurück, die 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 Boolean zurück, der angibt, ob das Medium gerade dabei ist, zu einer neuen Position zu springen.
HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext: Gibt einen String zurück, der die eindeutige ID des Audiogeräts zur Ausgabe angibt, oder einen leeren String, wenn das Standard-Audiogerät des User-Agent verwendet wird.
HTMLMediaElement.src: Ein String, der das HTML-Attribut src widerspiegelt und die URL einer Medienressource angibt, die verwendet werden soll.
HTMLMediaElement.srcObject: Ein Objekt, das als Quelle des mit dem HTMLMediaElement verbundenen Mediums dient, oder null, wenn nicht zugewiesen.
HTMLMediaElement.textTracks Schreibgeschützt: Gibt ein TextTrackList Objekt zurück, das die Liste der TextTrack Objekte im Element enthält.
HTMLMediaElement.videoTracks Schreibgeschützt: Gibt ein VideoTrackList Objekt zurück, das die Liste der VideoTrack Objekte im Element enthält.
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, oder null, wenn keiner zugeteilt ist.
HTMLMediaElement.mediaGroup Veraltet Nicht standardisiert: Ein String, der das HTML-Attribut mediagroup 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 Boolean zurück. Bezogen auf die Aufzeichnung von Audiostreams.
HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet: Ein double, das Zugriff auf die Fragmentendzeit bietet, wenn das Medienelement eine Fragment-URI für currentSrc 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 z. B. eine Spur für Untertitel) zu einem Medienelement hinzu. Dies ist eine programmatische Schnittstelle und wirkt sich nicht auf das DOM aus.
HTMLMediaElement.captureStream(): Gibt MediaStream zurück, erfasst einen Stream des Medieninhalts.
HTMLMediaElement.canPlayType(): Bei Angabe eines Strings, der einen MIME-Medientyp angibt (möglicherweise mit dem codecs Parameter enthalten), gibt canPlayType() den String probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn nicht genug 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(): Schnelles Springen 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 aus, die mit dem src Attribut oder dem <source> Element bereitgestellt wurden.
HTMLMediaElement.pause(): Pausiert die Medienwiedergabe.
HTMLMediaElement.play(): Beginnt die Wiedergabe des Mediums.
HTMLMediaElement.seekToNextFrame() Veraltet Nicht standardisiert: Springt zum nächsten Frame im Medium. Diese nicht standardisierte, experimentelle Methode macht es möglich, das Lesen und Rendern von Medien manuell mit einer benutzerdefinierten Geschwindigkeit zu steuern oder durch das Medium Frame für Frame zu gehen, um Filterung oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys() Sicherer Kontext: Gibt Promise zurück. Setzt die MediaKeys Schlüssel, die zur Entschlüsselung von Medien während der Wiedergabe verwendet werden.
HTMLMediaElement.setSinkId() Sicherer Kontext: Setzt die ID des Audiogeräts zur Ausgabe 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: Die Firefox-präfixierte Entsprechung von HTMLMediaElement.captureStream(). Weitere Details finden Sie in der Browser-Kompatibilität.
HTMLMediaElement.mozCaptureStreamUntilEnded() Nicht standardisiert Veraltet: [Beschreibung einfügen]
HTMLMediaElement.mozGetMetadata() Nicht standardisiert Veraltet: Gibt ein Object zurück, das Eigenschaften enthält, die Metadaten aus der spielenden 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 nach dem loadedmetadata Ereignisaufruf aufgerufen werden.

Ereignisse

Erbt Ereignisse von seinem Elternteil, HTMLElement .

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

abort: Wird ausgelöst, wenn die Ressource nicht vollständig geladen wurde, jedoch nicht infolge eines Fehlers.
canplay: Wird ausgelöst, wenn der User-Agent das Medium abspielen kann, jedoch schätzt, dass nicht genug Daten geladen wurden, um das Medium bis zu seinem Ende abzuspielen, ohne anhalten zu müssen, um mehr Inhalte zwischenzupuffern.
canplaythrough: Wird ausgelöst, wenn der User-Agent das Medium abspielen kann und schätzt, dass genug Daten geladen wurden, um das Medium bis zu seinem Ende abzuspielen, ohne anhalten zu müssen, um mehr Inhalte zu puffern.
durationchange: Wird ausgelöst, wenn die Duration-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 gestoppt wird, weil das Ende des Mediums (<audio> oder <video>) erreicht ist 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, die Wiedergabe zu pausieren, bearbeitet wird, und die Aktivität in den pausierten Zustand übergegangen ist. Dies tritt am häufigsten auf, wenn die HTMLMediaElement.pause() Methode des Mediums aufgerufen wird.
play: Wird ausgelöst, wenn die paused-Eigenschaft von true auf false geändert wird, als Ergebnis der HTMLMediaElement.play() Methode oder des autoplay Attributs.
playing: Wird ausgelöst, wenn die Wiedergabe nach einer Pause oder einer Verzögerung aufgrund fehlender Daten bereit zum Start ist.
progress: Wird periodisch ausgelöst, während der Browser eine Ressource lädt.
ratechange: Wird ausgelöst, wenn die Wiedergaberate 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 User-Agent versucht, Mediendaten abzurufen, die Daten aber unerwartet nicht bereitgestellt werden.
suspend: Wird ausgelöst, wenn das Laden von Mediendaten angehalten wurde.
timeupdate: Wird ausgelöst, wenn die Zeit, die durch die currentTime Eigenschaft angegeben wird, aktualisiert wurde.
volumechange: Wird ausgelöst, wenn die Lautstärke geändert wurde.
waiting: Wird ausgelöst, wenn die Wiedergabe wegen eines vorübergehenden Mangels an Daten angehalten ist.
waitingforkey: Wird ausgelöst, wenn die Wiedergabe beim Warten auf einen Schlüssel erstmals blockiert wird.

Spezifikationen

Specification
HTML # htmlmediaelement

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

Leitfäden

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden