HTMLMediaElement

Baseline Weitgehend verfügbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Die HTMLMediaElement-Schnittstelle erweitert HTMLElement um die Eigenschaften und Methoden, die erforderlich sind, um grundlegende medienbezogene Funktionen zu unterstützen, die sowohl für Audio als auch für Video verbreitet sind.

Die HTMLVideoElement und HTMLAudioElement Elemente erben beide diese Schnittstelle.

Instanz-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihren Vorfahren HTMLElement, Element, Node, und EventTarget.

HTMLMediaElement.audioTracks Schreibgeschützt: Eine AudioTrackList, die die im Element enthaltenen AudioTrack-Objekte 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 sie unterbrechungsfrei abzuspielen.

Hinweis: Audio automatisch abzuspielen, 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 den Autoplay-Leitfaden für Medien und Web Audio APIs für weitere Informationen. Beachten Sie, dass Browser Autoplay-Anfragen ignorieren können, daher sollten Sie sicherstellen, 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 anzeigt, die der Browser momentan gepuffert 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ä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, wann immer der Benutzeragent seine eigene Kontrollsatz anzeigt. Die DOMTokenList kann einen oder mehrere der drei möglichen Werte enthalten: 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 Gleitkommawert mit doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium noch nicht zu spielen begonnen hat und nicht gesucht wurde, ist dieser Wert die anfängliche Wiedergabezeit des Mediums. Das Setzen dieses Wertes springt das Medium zu der neuen Zeit. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.
HTMLMediaElement.defaultMuted: Ein boolescher Wert, das das HTML-Attribut muted widerspiegelt, welches 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 boolescher Wert, der den Status der Fernwiedergabe setzt oder zurückgibt und angibt, ob das Medienelement eine UI für die Fernwiedergabe haben darf.
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, wird der Wert NaN zurückgegeben. Wenn das Medium eine unbestimmte Länge hat (wie bei gestreamten Live-Medien, einem WebRTC-Anrufmedium oder ähnlichem), 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 letzten Fehler zurück oder null, wenn es keinen Fehler gegeben hat.
HTMLMediaElement.loading Experimentell: Ein String, der angibt, ob der Browser das Medium sofort (eager) oder bei Bedarf (lazy) laden soll. Siehe HTML-Attribute <video loading> und <audio loading> für mehr Informationen.
HTMLMediaElement.loop: Ein boolescher Wert, der das HTML-Attribut loop widerspiegelt, welches angibt, ob das Medienelement erneut beginnen 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 verwenden kann, um Mediendaten während der Wiedergabe zu entschlüsseln. Wenn kein Schlüssel verfügbar ist, kann es null sein.
HTMLMediaElement.muted: Ein boolescher Wert, der angibt, ob der Ton stummgeschaltet ist. true, wenn der Ton stummgeschaltet ist, andernfalls false.
HTMLMediaElement.networkState Schreibgeschützt: Gibt einen unsigned short (Enumeration) zurück, der den aktuellen Zustand des Abrufs des Mediums über das Netzwerk anzeigt.
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 abgespielt 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 des Klangs beibehalten wird. Wenn auf false gesetzt, passt sich die Tonhöhe an die 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 eine Instanz des RemotePlayback-Objekts 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 angibt, ob das Medium dabei ist, eine neue Position zu suchen.
HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext: Gibt einen String zurück, der die eindeutige ID des Ausgabegeräts für Audio darstellt, oder einen leeren String, wenn das Standard-Audiogerät des Benutzeragenten verwendet wird.
HTMLMediaElement.src: Ein String, der das HTML-Attribut src widerspiegelt und die URL einer zu verwendenden Medienressource enthält.
HTMLMediaElement.srcObject: Ein Objekt, das als Quelle des mit dem HTMLMediaElement verknüpften Mediums 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 (leise) bis 1.0 (am lautesten).

Veraltete Eigenschaften

Diese Eigenschaften sind veraltet und sollten nicht mehr verwendet werden, auch wenn ein Browser sie noch unterstützt.

HTMLMediaElement.controller Veraltet Nicht standardisiert: Ein MediaController-Objekt, das den Media-Controller repräsentiert, der dem Element zugewiesen ist, oder null, wenn keiner zugewiesen ist.
HTMLMediaElement.mediaGroup Veraltet Nicht standardisiert: Ein String, der das mediagroup HTML-Attribut widerspiegelt, das 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. Bezieht sich auf die Erfassung von Audiostreams.
HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet: Ein double, das den Zugriff auf die Fragment-Endzeit bietet, wenn das Medienelement eine Fragment-URI für currentSrc hat, andernfalls ist es gleich der Mediendauer.

Instanz-Methoden

Diese Schnittstelle erbt auch Methoden von ihren Vorfahren HTMLElement, Element, Node, und EventTarget.

HTMLMediaElement.addTextTrack(): Fügt einem Medienelement ein neues TextTrack-Objekt hinzu (wie ein Untertitel-Track). Dies ist eine programmatische Schnittstelle und beeinflusst nicht das DOM.
HTMLMediaElement.captureStream(): Gibt ein MediaStream zurück, das einen Stream des Medieninhalts erfasst.
HTMLMediaElement.canPlayType(): Bei Angabe eines Strings, der einen MIME Medientyp (möglicherweise mit dem codecs Parameter) spezifiziert, gibt canPlayType() den String probably zurück, wenn das Medium abspielbar sein sollte, maybe, wenn nicht genügend Informationen vorliegen, um festzustellen, ob das Medium abgespielt wird oder nicht, oder einen leeren String, wenn das Medium nicht abgespielt werden kann.
HTMLMediaElement.fastSeek(): Sucht schnell mit geringer Präzision zur angegebenen Zeit.
HTMLMediaElement.getStartDate(): Gibt ein Date-Objekt zurück, das das reale Datum und die Uhrzeit repräsentiert, die dem Beginn des Mediums entsprechen. Für Live-Streams ist dies die Zeit, zu der die Übertragung auf dem Server begann, was vor dem Zeitpunkt sein kann, zu dem der Benutzer mit dem Anschauen begann.
HTMLMediaElement.load(): Setzt das Medium an den Anfang zurück und wählt die beste verfügbare Quelle aus den mithilfe des src-Attributs oder dem <source>-Element bereitgestellten Quellen aus.
HTMLMediaElement.pause(): Pausiert die Medienwiedergabe.
HTMLMediaElement.play(): Beginnt die Wiedergabe des Mediums.
HTMLMediaElement.seekToNextFrame() Veraltet Nicht standardisiert: Sucht zum nächsten Bild im Medium. Diese nicht-standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien manuell mit einer benutzerdefinierten Geschwindigkeit zu steuern, oder durch das Medium Bild für Bild zu navigieren, um Filterung oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys() Sicherer Kontext: Gibt Promise zurück. Legt fest, welche MediaKeys bei der Entschlüsselung von Medien während der Wiedergabe verwendet werden.
HTMLMediaElement.setSinkId() Sicherer Kontext: Legt die ID des Audiogeräts fest, 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 mehr verwendet werden, auch wenn ein Browser sie noch unterstützt.

HTMLMediaElement.mozCaptureStream() Nicht standardisiert: Die mit einem Firefox-Präfix versehene Entsprechung von HTMLMediaElement.captureStream(). Siehe dessen Browser-Kompatibilität für Details.
HTMLMediaElement.mozCaptureStreamUntilEnded() Nicht standardisiert Veraltet: Eine nicht standardisierte, veraltete Methode zum Erfassen des Streams, bis dieser zu Ende ist.
HTMLMediaElement.mozGetMetadata() Nicht standardisiert Veraltet: Gibt ein Object zurück, das Eigenschaften enthält, die Metadaten aus der abspielenden Medienquelle 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-Ereignis aufgerufen werden.

Ereignisse

Ereignisse von seinem übergeordneten Element, HTMLElement, werden geerbt.

Diese Ereignisse können mit addEventListener() gehört werden oder durch Zuweisung eines Event-Listeners zur oneventname-Eigenschaft dieser Schnittstelle.

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 genügend Daten geladen wurden, um das Medium 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 genug Daten geladen wurden, um das Medium bis zum Ende abzuspielen, ohne für weiteres Puffern des Inhalts anhalten zu müssen.
durationchange: Wird ausgelöst, wenn die Eigenschaft für die Dauer aktualisiert wurde.
emptied: Wird ausgelöst, wenn das Medium leer geworden ist; zum Beispiel, wenn das Medium bereits geladen ist (oder teilweise geladen war) und die Methode HTMLMediaElement.load() aufgerufen wird, um es neu zu laden.
encrypted: Wird ausgelöst, wenn Initialisierungsdaten im Medium gefunden werden, die darauf hinweisen, dass das Medium verschlüsselt ist.
ended: Wird ausgelöst, wenn die Wiedergabe stoppt, wenn das Ende des Mediums (<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 das erste Bild des Mediums fertig geladen ist.
loadedmetadata: Wird ausgelöst, wenn Metadaten geladen wurden.
loadstart: Wird ausgelöst, wenn der Browser begonnen hat, eine Ressource zu laden.
pause: Wird ausgelöst, wenn ein Pausieren der Wiedergabe angefordert wurde und die Aktivität ihren pausierten Zustand erreicht hat, am häufigsten wenn die Methode HTMLMediaElement.pause() des Mediums aufgerufen wird.
play: Wird ausgelöst, wenn die paused-Eigenschaft von true auf false geändert wurde, als Ergebnis der Methode HTMLMediaElement.play() oder dem autoplay Attribut.
playing: Wird ausgelöst, wenn die Wiedergabe bereit ist zu starten, nachdem sie pausiert oder durch Datenmangel verzögert wurde.
progress: Wird periodisch ausgelöst, während der Browser eine Ressource lädt.
ratechange: Wird ausgelöst, wenn sich die Wiedergabegeschwindigkeit geändert hat.
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, Daten jedoch unerwartet nicht bereitgestellt werden.
suspend: Wird ausgelöst, wenn das Laden der Mediendaten angehalten wurde.
timeupdate: Wird ausgelöst, wenn die durch die currentTime-Eigenschaft angezeigte 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 wird, während auf einen Schlüssel gewartet wird.

Spezifikationen

Spezifikation
HTML # htmlmediaelement

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

Leitfäden

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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