HTMLMediaElement

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

HTMLMediaElement.audioTracks

Eine AudioTrackList, die 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 ohne Unterbrechung verfügbar sind.

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. Weitere Informationen finden Sie im Leitfaden zum automatischen Abspielen von Medien und Web Audio APIs. Beachten Sie, dass Browser Autoplay-Anfragen ignorieren können, sodass Ihr Code nicht davon abhängig sein sollte, dass Autoplay funktioniert.

HTMLMediaElement.buffered Schreibgeschützt

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

HTMLMediaElement.controls

Ein boolescher Wert, der das HTML-Attribut controls widerspiegelt und angibt, ob Benutzeroberfläche-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 Mediaelement angezeigt werden sollen, wann immer der Benutzeragent seine eigenen Steuerelemente anzeigt. Die DOMTokenList akzeptiert einen oder mehrere der drei möglichen Werte: nodownload, nofullscreen und noremoteplayback.

HTMLMediaElement.crossOrigin

Eine Zeichenkette, die die CORS-Einstellung für dieses Medienelement angibt.

HTMLMediaElement.currentSrc Schreibgeschützt

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

HTMLMediaElement.currentTime

Ein Doppel-Präzisions-Gleitkommawert, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn die Medienwiedergabe nicht gestartet wurde und nicht verschoben wurde, ist dieser Wert die anfängliche Wiedergabezeit der Medien. Beim Setzen dieses Wertes wird das Medium auf die neue Zeit verschoben. Die Zeit wird relativ zur Zeitleiste der Medien angegeben.

HTMLMediaElement.defaultMuted

Ein boolescher Wert, der das HTML-Attribut muted widerspiegelt, welches 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 Fernwiedergabestatus setzt oder zurückgibt und angibt, ob das Medienelement eine Fernwiedergabe-Benutzeroberfläche haben darf.

HTMLMediaElement.duration Schreibgeschützt

Ein schreibgeschützter Doppel-Präzisions-Gleitkommawert, der die Gesamtdauer der Medien in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, wird der Wert NaN zurückgegeben. Wenn die Medien von unbestimmter Länge sind (wie z. B. gestreamte Live-Medien, Medien eines WebRTC-Anrufs oder ähnliches), ist der Wert +Unendlichkeit.

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 neuesten Fehler zurück, oder null, wenn kein Fehler aufgetreten ist.

HTMLMediaElement.loop

Ein boolescher Wert, der das HTML-Attribut loop widerspiegelt, welches angibt, ob das Medienelement von vorne 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, und false andernfalls.

HTMLMediaElement.networkState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der den aktuellen Status des Abrufens der Medien ü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, der die Rate angibt, mit der die Medien abgespielt werden.

HTMLMediaElement.played Schreibgeschützt

Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Medienquelle enthält, die der Browser bereits abgespielt hat, falls vorhanden.

HTMLMediaElement.preload

Eine Zeichenkette, die 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 des Klangs beibehalten wird. Wenn auf false gesetzt, wird die Tonhöhe an die Geschwindigkeit des Audios angepasst.

HTMLMediaElement.readyState Schreibgeschützt

Gibt einen unsigned short (Enumeration) zurück, der den Bereitschaftszustand der Medien angibt.

HTMLMediaElement.remote Schreibgeschützt

Gibt ein RemotePlayback-Objekt zurück, das dem Medienelement zugeordnet 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 die Medien gerade dabei sind, zu einer neuen Position zu springen.

HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext

Gibt einen String zurück, der die eindeutige ID des Audioausgabegeräts angibt, oder einen leeren String, wenn das Standard-Audiogerät des Benutzeragents verwendet wird.

HTMLMediaElement.src

Ein String, der das HTML-Attribut src widerspiegelt, das die URL einer zu verwendenden Medienressource enthält.

HTMLMediaElement.srcObject

Ein Objekt, das als Quelle für die mit dem HTMLMediaElement assoziierte Medien 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 angibt, von 0.0 (stumm) bis 1.0 (laut).

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, welches den Namen der Gruppe von Elementen angibt, zu der es gehört. Eine Gruppe von Medienelementen teilt einen gemeinsamen MediaController.

HTMLMediaElement.mozAudioCaptured Schreibgeschützt Nicht standardisiert Veraltet

Gibt einen booleschen Wert zurück. In Bezug auf die Erfassung von Audiostreams.

HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet

Ein double, der Zugriff auf die Segmentendzeit bietet, wenn das Medienelement eine Segment-URL für currentSrc hat, andernfalls ist er gleich der Mediendauer.

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

HTMLMediaElement.addTextTrack()

Fügt einem Medienelement ein neues TextTrack-Objekt hinzu (z. B. eine Spur für Untertitel). Dies ist eine programmatische Schnittstelle und wirkt sich nicht auf das DOM aus.

HTMLMediaElement.captureStream()

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

HTMLMediaElement.canPlayType()

Bei Angabe eines Strings, der einen MIME-Medientyp (möglicherweise mit dem codecs-Parameter) angibt, gibt canPlayType() den String probably zurück, wenn die Medien wahrscheinlich abspielbar sind, maybe, wenn nicht genügend Informationen vorliegen, um festzustellen, ob die Medien abgespielt werden können, oder einen leeren String, wenn die Medien nicht abgespielt werden können.

HTMLMediaElement.fastSeek()

Springt schnell mit niedriger Präzision zur angegebenen Zeit.

HTMLMediaElement.load()

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

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, Lesen und Rendern der Medien mit einer benutzerdefinierten Geschwindigkeit manuell zu steuern oder Bild-für-Bild durch die Medien zu navigieren, um Filter oder andere Operationen durchzuführen.

HTMLMediaElement.setMediaKeys() Sicherer Kontext

Gibt ein Promise zurück. Setzt die MediaKeys-Schlüssel, um Medien während der Wiedergabe zu entschlüsseln.

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, selbst wenn ein Browser sie noch unterstützt.

HTMLMediaElement.mozCaptureStream() Nicht standardisiert

Das mit Firefox präfixierte Äquivalent von HTMLMediaElement.captureStream(). Siehe seine Browser-Kompatibilität für Details.

HTMLMediaElement.mozCaptureStreamUntilEnded() Nicht standardisiert Veraltet

[Beschreibung eingeben]

HTMLMediaElement.mozGetMetadata() Nicht standardisiert Veraltet

Gibt ein 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 Elternteil, HTMLElement.

Hören Sie auf diese Ereignisse, indem Sie addEventListener() verwenden oder einen Ereignis-Listener auf die oneventname-Eigenschaft dieser Schnittstelle zuweisen.

abort

Ausgelöst, wenn die Ressource nicht vollständig geladen wurde, aber nicht als Ergebnis eines Fehlers.

canplay

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 des Inhalts anzuhalten.

canplaythrough

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 des Inhalts anzuhalten.

durationchange

Ausgelöst, wenn die Eigenschaft für die Dauer aktualisiert wurde.

emptied

Ausgelöst, wenn die Medien leer geworden sind; zum Beispiel, wenn die Medien bereits geladen (oder teilweise geladen) sind und die HTMLMediaElement.load()-Methode aufgerufen wird, um sie neu zu laden.

encrypted

Ausgelöst, wenn Initialisierungsdaten in den Medien gefunden werden, die darauf hinweisen, dass die Medien verschlüsselt sind.

ended

Ausgelöst, wenn die Wiedergabe stoppt, weil das Ende der Medien (<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 das erste Frame der Medien vollständig 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 Pause-Anfrage bearbeitet wird und die Aktivität ihren pausierten Zustand erreicht hat, was am häufigsten auftritt, wenn die HTMLMediaElement.pause()-Methode des Mediums aufgerufen wird.

play

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

playing

Ausgelöst, wenn die Wiedergabe startbereit ist, nachdem sie paussiert oder aufgrund von Datenmangel verzögert wurde.

progress

Regelmäßig ausgelöst, während der Browser eine Ressource lädt.

ratechange

Ausgelöst, wenn die Wiedergaberate geändert wurde.

seeked

Ausgelöst, wenn eine Suche (seek) abgeschlossen ist.

seeking

Ausgelöst, wenn eine Suche (seek) beginnt.

stalled

Ausgelöst, wenn der Benutzeragent versucht, Mediendaten abzurufen, aber keine Daten unerwarteterweise eintreffen.

suspend

Ausgelöst, wenn das Laden von Mediendaten ausgesetzt wurde.

timeupdate

Ausgelöst, wenn die durch die currentTime-Eigenschaft angegebene Zeit aktualisiert wurde.

volumechange

Ausgelöst, wenn die Lautstärke geändert wurde.

waiting

Ausgelöst, wenn die Wiedergabe gestoppt hat, aufgrund eines vorübergehenden Mangels an Daten.

waitingforkey

Ausgelöst, wenn die Wiedergabe das erste Mal blockiert wird, während auf einen Schlüssel gewartet wird.

• <video> und <audio> HTML-Elemente
• HTMLVideoElement und HTMLAudioElement-Interfaces, die von HTMLMediaElement abgeleitet sind

• Webmedientechnologien
• Lernbereich: HTML Video und Audio
• Leitfaden zu Medientypen und -formaten
• Umgang mit Problemen in der Medienunterstützung in Web-Inhalten