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 Schnittstelle HTMLMediaElement erweitert HTMLElement um die Eigenschaften und Methoden, die für grundlegende Medienfunktionen benötigt werden, die Audio und Video gemeinsam haben.

Die Elemente HTMLVideoElement und HTMLAudioElement erben beide diese Schnittstelle.

Instanzeigenschaften

Diese Schnittstelle erbt außerdem 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. Er gibt an, ob die Wiedergabe automatisch beginnen soll, sobald genügend Mediendaten für eine unterbrechungsfreie Wiedergabe verfügbar sind.

Hinweis: Das automatische Abspielen von Audio, wenn Benutzer es nicht erwarten oder wünschen, beeinträchtigt die Benutzererfahrung und sollte in den meisten Fällen vermieden werden, auch wenn es Ausnahmen gibt. Weitere Informationen finden Sie im Leitfaden zur automatischen Wiedergabe für Medien- und Web-Audio-APIs. Beachten Sie, dass Browser Anfragen zur automatischen Wiedergabe ignorieren können. Stellen Sie daher sicher, dass Ihr Code nicht davon abhängt, dass die automatische Wiedergabe funktioniert.
HTMLMediaElement.buffered Schreibgeschützt: Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Medienquelle angibt, die der Browser zum Zeitpunkt des Zugriffs auf die Eigenschaft buffered gepuffert hat, sofern vorhanden.
HTMLMediaElement.controls: Ein boolescher Wert, der das HTML-Attribut controls widerspiegelt. Er gibt an, ob Bedienelemente für die Ressource angezeigt werden sollen.
HTMLMediaElement.controlsList: Gibt eine DOMTokenList zurück, die dem User-Agent dabei hilft auszuwählen, welche Bedienelemente auf dem Medienelement angezeigt werden sollen, wenn der User-Agent eigene Bedienelemente anzeigt. Die DOMTokenList enthält einen oder mehrere von drei möglichen Werten: nodownload, nofullscreen und noremoteplayback.
HTMLMediaElement.crossOrigin: Eine Zeichenfolge, die 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: Eine Gleitkommazahl mit doppelter Genauigkeit, die die aktuelle Wiedergabezeit in Sekunden angibt. Wenn die Wiedergabe des Mediums noch nicht begonnen hat und noch keine Suchoperation durchgeführt wurde, entspricht dieser Wert der anfänglichen Wiedergabezeit des Mediums. Wird dieser Wert gesetzt, springt die Wiedergabe zur neuen Zeitposition. Die Zeit wird relativ zur Zeitleiste des Mediums angegeben.
HTMLMediaElement.defaultMuted: Ein boolescher Wert, der das HTML-Attribut muted widerspiegelt. Er gibt an, ob die Audioausgabe des Medienelements standardmäßig stummgeschaltet sein soll.
HTMLMediaElement.defaultPlaybackRate: Ein double, der die Standard-Wiedergabegeschwindigkeit des Mediums angibt.
HTMLMediaElement.disableRemotePlayback: Ein boolescher Wert, der den Status der Remote-Wiedergabe setzt oder zurückgibt und angibt, ob für das Medienelement eine Benutzeroberfläche zur Remote-Wiedergabe zulässig ist.
HTMLMediaElement.duration Schreibgeschützt: Eine schreibgeschützte Gleitkommazahl mit doppelter Genauigkeit, die die Gesamtdauer des Mediums in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, wird NaN zurückgegeben. Hat das Medium eine unbegrenzte Dauer, etwa bei einem Livestream oder den Medien eines WebRTC-Anrufs, lautet der Wert Infinity.
HTMLMediaElement.ended Schreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob die Wiedergabe des Medienelements beendet ist.
HTMLMediaElement.error Schreibgeschützt: Gibt ein MediaError-Objekt für den letzten Fehler zurück oder null, wenn kein Fehler aufgetreten ist.
HTMLMediaElement.loading: Eine Zeichenfolge, die angibt, ob der Browser das Medium sofort (eager) oder erst bei Bedarf (lazy) laden soll. Weitere Informationen finden Sie bei den HTML-Attributen <video loading> und <audio loading>.
HTMLMediaElement.loop: Ein boolescher Wert, der das HTML-Attribut loop widerspiegelt. Er gibt an, ob das Medienelement nach Erreichen des Endes von vorn beginnen soll.
HTMLMediaElement.mediaKeys Schreibgeschützt Sicherer Kontext: Gibt ein MediaKeys-Objekt zurück, das einen Satz von Schlüsseln enthält, mit denen das Element Mediendaten während der Wiedergabe entschlüsseln kann. Wenn kein Schlüssel verfügbar ist, kann der Wert null sein.
HTMLMediaElement.muted: Ein boolescher Wert, der festlegt, ob die Audioausgabe stummgeschaltet ist. Der Wert ist true, wenn die Audioausgabe stummgeschaltet ist, andernfalls false.
HTMLMediaElement.networkState Schreibgeschützt: Gibt einen unsigned short (Aufzählungswert) zurück, der den aktuellen Status des Abrufs des Mediums über das Netzwerk angibt.
HTMLMediaElement.paused Schreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob die Wiedergabe des Medienelements pausiert ist.
HTMLMediaElement.playbackRate: Ein double, der die Geschwindigkeit angibt, mit der das Medium wiedergegeben wird.
HTMLMediaElement.played Schreibgeschützt: Gibt ein TimeRanges-Objekt zurück, das die bereits wiedergegebenen Bereiche der Medienquelle enthält, sofern vorhanden.
HTMLMediaElement.preload: Eine Zeichenfolge, die das HTML-Attribut preload widerspiegelt und angibt, welche Daten gegebenenfalls vorab geladen werden sollen. Mögliche Werte sind none, metadata und auto.
HTMLMediaElement.preservesPitch: Ein boolescher Wert, der festlegt, ob die Tonhöhe erhalten bleibt. Bei false passt sich die Tonhöhe an die Wiedergabegeschwindigkeit an.
HTMLMediaElement.readyState Schreibgeschützt: Gibt einen unsigned short (Aufzählungswert) zurück, der den Bereitschaftsstatus des Mediums angibt.
HTMLMediaElement.remote Schreibgeschützt: Gibt eine dem Medienelement zugeordnete Instanz eines RemotePlayback-Objekts zurück.
HTMLMediaElement.seekable Schreibgeschützt: Gibt ein TimeRanges-Objekt zurück, das die Zeitbereiche enthält, zu denen Benutzer springen können, sofern vorhanden.
HTMLMediaElement.seeking Schreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob gerade zu einer neuen Position im Medium gesprungen wird.
HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext: Gibt eine Zeichenfolge mit der eindeutigen ID des Audioausgabegeräts zurück oder eine leere Zeichenfolge, wenn das Standard-Audioausgabegerät des User-Agents verwendet wird.
HTMLMediaElement.src: Eine Zeichenfolge, die das HTML-Attribut src widerspiegelt. Dieses enthält die URL der zu verwendenden Medienressource.
HTMLMediaElement.srcObject: Ein Objekt, das als Quelle des dem HTMLMediaElement zugeordneten Mediums dient, oder null, wenn keine Quelle zugewiesen wurde.
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 (maximale Lautstärke).

Veraltete Eigenschaften

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

HTMLMediaElement.controller: Ein MediaController-Objekt, das den dem Element zugewiesenen Mediencontroller darstellt, oder null, wenn keiner zugewiesen ist.
HTMLMediaElement.mediaGroup: Eine Zeichenfolge, die das HTML-Attribut mediagroup widerspiegelt. Dieses gibt den Namen der Gruppe an, zu der das Element gehört. Eine Gruppe von Medienelementen verwendet einen gemeinsamen MediaController.
HTMLMediaElement.mozAudioCaptured Schreibgeschützt: Gibt einen booleschen Wert zurück. Steht im Zusammenhang mit der Erfassung von Audiostreams.
HTMLMediaElement.mozFragmentEnd Schreibgeschützt: Ein double, der Zugriff auf die Endzeit des Fragments bietet, wenn das Medienelement für currentSrc eine Fragment-URI hat. Andernfalls entspricht der Wert der Dauer des Mediums.

Instanzmethoden

Diese Schnittstelle erbt außerdem Methoden von ihren Vorfahren HTMLElement, Element, Node und EventTarget.

HTMLMediaElement.addTextTrack(): Fügt einem Medienelement ein neues TextTrack-Objekt hinzu, beispielsweise eine Untertitelspur. Dies ist ausschließlich eine programmatische Schnittstelle und hat keine Auswirkungen auf das DOM.
HTMLMediaElement.captureStream(): Erfasst einen Stream des Medieninhalts und gibt einen MediaStream zurück.
HTMLMediaElement.canPlayType(): Wenn eine Zeichenfolge übergeben wird, die einen MIME-Medientyp angibt und gegebenenfalls den Parameter codecs enthält, gibt canPlayType() die Zeichenfolge probably zurück, wenn das Medium voraussichtlich abgespielt werden kann, maybe, wenn nicht genügend Informationen für eine Beurteilung vorliegen, oder eine leere Zeichenfolge, wenn das Medium nicht abgespielt werden kann.
HTMLMediaElement.fastSeek(): Springt schnell und mit geringer Genauigkeit zur angegebenen Zeitposition.
HTMLMediaElement.getStartDate(): Gibt ein Date-Objekt zurück, das das tatsächliche Datum und die Uhrzeit des Medienbeginns darstellt. Bei Livestreams ist dies der Zeitpunkt, zu dem die Übertragung auf dem Server begann; er kann vor dem Zeitpunkt liegen, zu dem Benutzer mit dem Ansehen begonnen haben.
HTMLMediaElement.load(): Setzt das Medium auf den Anfang zurück und wählt die am besten geeignete verfügbare Quelle aus den Quellen aus, die über das Attribut src oder das Element <source> angegeben wurden.
HTMLMediaElement.pause(): Pausiert die Medienwiedergabe.
HTMLMediaElement.play(): Beginnt die Wiedergabe des Mediums.
HTMLMediaElement.seekToNextFrame(): Springt zum nächsten Frame des Mediums. Diese nicht standardisierte, experimentelle Methode ermöglicht es, das Lesen und Rendern von Medien manuell mit einer eigenen Geschwindigkeit zu steuern oder sich Frame für Frame durch das Medium zu bewegen, um Filter oder andere Operationen auszuführen.
HTMLMediaElement.setMediaKeys() Sicherer Kontext: Gibt eine Promise zurück. Legt die MediaKeys-Schlüssel fest, die beim Entschlüsseln des Mediums während der Wiedergabe verwendet werden.
HTMLMediaElement.setSinkId() Sicherer Kontext: Legt die ID des für die Ausgabe zu verwendenden Audiogeräts fest und gibt eine Promise zurück. Dies funktioniert nur, wenn die Anwendung zur Verwendung des angegebenen Geräts berechtigt ist.

Veraltete Methoden

Diese Methoden sind veraltet und sollten nicht verwendet werden, selbst wenn ein Browser sie noch unterstützt.

HTMLMediaElement.mozCaptureStream(): Das Firefox-spezifische Äquivalent von HTMLMediaElement.captureStream(). Einzelheiten finden Sie unter Browser-Kompatibilität.
HTMLMediaElement.mozCaptureStreamUntilEnded(): Eine nicht standardisierte, veraltete Methode, um den Stream bis zu seinem Ende zu erfassen.
HTMLMediaElement.mozGetMetadata(): Gibt ein Object zurück, dessen Eigenschaften die Metadaten der wiedergegebenen Medienressource als {key: value}-Paare darstellen. Bei jedem Methodenaufruf wird eine separate Kopie der Daten zurückgegeben. Diese Methode muss aufgerufen werden, nachdem das Ereignis loadedmetadata ausgelöst wurde.

Ereignisse

Erbt Ereignisse von der übergeordneten Schnittstelle HTMLElement.

Sie können diese Ereignisse mit addEventListener() überwachen oder der Eigenschaft oneventname dieser Schnittstelle einen Event-Listener zuweisen.

abort: Wird ausgelöst, wenn die Ressource nicht vollständig geladen wurde, ohne dass ein Fehler die Ursache war.
canplay: Wird ausgelöst, wenn der User-Agent das Medium abspielen kann, aber davon ausgeht, dass nicht genügend Daten geladen wurden, um es ohne Unterbrechung zum Nachpuffern bis zum Ende abzuspielen.
canplaythrough: Wird ausgelöst, wenn der User-Agent das Medium abspielen kann und davon ausgeht, dass genügend Daten geladen wurden, um es ohne Unterbrechung zum Nachpuffern bis zum Ende abzuspielen.
durationchange: Wird ausgelöst, wenn die Eigenschaft für die Dauer aktualisiert wurde.
emptied: Wird ausgelöst, wenn das Medium geleert wurde, beispielsweise wenn es bereits vollständig oder teilweise geladen war und die Methode HTMLMediaElement.load() aufgerufen wird, um es erneut zu laden.
encrypted: Wird ausgelöst, wenn im Medium Initialisierungsdaten gefunden werden, die darauf hinweisen, dass das Medium verschlüsselt ist.
ended: Wird ausgelöst, wenn die Wiedergabe endet, weil das Ende des Mediums (<audio> oder <video>) erreicht wurde oder 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 vollständig 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 verarbeitet wurde und die Wiedergabe in den pausierten Zustand übergegangen ist. Dies geschieht meist, wenn die Methode HTMLMediaElement.pause() des Mediums aufgerufen wird.
play: Wird ausgelöst, wenn die Eigenschaft paused infolge eines Aufrufs der Methode HTMLMediaElement.play() oder aufgrund des Attributs autoplay von true zu false wechselt.
playing: Wird ausgelöst, wenn die Wiedergabe nach einer Pause oder einer Verzögerung aufgrund fehlender Daten beginnen kann.
progress: Wird regelmäßig 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 eine Suchoperation abgeschlossen ist.
seeking: Wird ausgelöst, wenn eine Suchoperation beginnt.
stalled: Wird ausgelöst, wenn der User-Agent versucht, Mediendaten abzurufen, aber unerwartet keine Daten eintreffen.
suspend: Wird ausgelöst, wenn das Laden der Mediendaten ausgesetzt wurde.
timeupdate: Wird ausgelöst, wenn die von der Eigenschaft currentTime angegebene 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 Datenmangels angehalten wurde.
waitingforkey: Wird ausgelöst, wenn die Wiedergabe erstmals blockiert wird, während auf einen Schlüssel gewartet wird.

Spezifikationen

Spezifikation
HTML # htmlmediaelement

Die HTML-Elemente <video> und <audio>
Die von HTMLMediaElement abgeleiteten Schnittstellen HTMLVideoElement und HTMLAudioElement

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