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 mit den Eigenschaften und Methoden, die erforderlich sind, um grundlegende, medienbezogene Funktionen zu unterstützen, die bei Audio und Video üblich sind.

Die HTMLVideoElement und HTMLAudioElement Elemente erben beide von dieser Schnittstelle.

Instanz-Eigenschaften

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

HTMLMediaElement.audioTracks Schreibgeschützt: Eine AudioTrackList, die die AudioTrack-Objekte im Element auflistet.
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. Weitere Informationen finden Sie im Leitfaden für automatisches Abspielen von Medien und Web Audio APIs. Beachten Sie, dass Browser Autoplay-Anfragen möglicherweise ignorieren, daher sollten Sie sicherstellen, dass Ihr Code nicht davon abhängt, dass das 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), zu dem Zeitpunkt, an dem die buffered Eigenschaft aufgerufen 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 zu entscheiden, welche Steuerelemente auf dem Medienelement angezeigt werden sollen, wenn der Benutzeragent seine eigenen Steuerelemente anzeigt. Die DOMTokenList enthält einen oder mehrere der drei möglichen Werte: nodownload, nofullscreen und noremoteplayback.
HTMLMediaElement.crossOrigin: Ein String, der 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 Gleitkommawert mit doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn die Medien nicht gestartet haben zu spielen und nicht gesucht wurden, ist dieser Wert die anfängliche Wiedergabezeit der Medien. Durch Setzen dieses Wertes wird das Medium an die neue Zeit gesucht. Die Zeit wird relativ zur Zeitachse der Medien angegeben.
HTMLMediaElement.defaultMuted: Ein boolescher Wert, der das muted HTML-Attribut widerspiegelt, das angibt, ob die Audioausgabe des Medienelements standardmäßig stummgeschaltet sein soll.
HTMLMediaElement.defaultPlaybackRate: Ein double, der die Standard-Wiedergabegeschwindigkeit der Medien angibt.
HTMLMediaElement.disableRemotePlayback: Ein boolescher Wert, der den Zustand der Remote-Wiedergabe setzt oder zurückgibt, was anzeigt, ob das Medienelement eine Benutzeroberfläche für die Remote-Wiedergabe haben darf.
HTMLMediaElement.duration Schreibgeschützt: Ein schreibgeschützter Gleitkommawert mit doppelter Genauigkeit, der die gesamte Dauer der Medien in Sekunden angibt. Wenn keine Mediendaten verfügbar sind, ist der zurückgegebene Wert NaN. Wenn die Medien eine unbestimmte Länge haben (wie gestreamte Live-Medien, ein WebRTC-Anruf oder Ähnliches), 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 kein Fehler aufgetreten ist.
HTMLMediaElement.loop: Ein boolescher Wert, der das loop HTML-Attribut widerspiegelt, das angibt, ob das Medienelement neu starten soll, wenn es sein 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 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 Status des Ladevorgangs 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, das die Geschwindigkeit 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 abgespielt hat, falls vorhanden.
HTMLMediaElement.preload: Ein String, der das preload HTML-Attribut 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 Tons 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 der Medien angibt.
HTMLMediaElement.remote Schreibgeschützt: Gibt ein RemotePlayback-Objekt 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 in den Prozess des Suchens nach einer neuen Position versetzt wird.
HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext: Gibt einen String zurück, der die eindeutige ID des Audiogeräts darstellt, das die Ausgabe liefert, oder einen leeren String, wenn das Standard-Audiogerät des Benutzeragenten verwendet wird.
HTMLMediaElement.src: Ein String, der das src HTML-Attribut widerspiegelt und die URL einer zu verwendenden Medienressource enthält.
HTMLMediaElement.srcObject: Ein Objekt, das als Quelle der mit dem HTMLMediaElement verbundenen Medien dient, oder null, wenn es nicht zugewiesen ist.
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 des Audios angibt, von 0.0 (stumm) bis 1.0 (am lautesten).

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 zugewiesen ist.
HTMLMediaElement.mediaGroup Veraltet Nicht standardisiert: Ein String, der das mediagroup HTML-Attribut widerspiegelt und den Namen der Gruppe angibt, zu der die Elemente gehören. Eine Gruppe von Medienelementen teilt sich einen gemeinsamen MediaController.
HTMLMediaElement.mozAudioCaptured Schreibgeschützt Nicht standardisiert Veraltet: Gibt einen booleschen Wert zurück. Steht im Zusammenhang mit der Aufnahme von Audiostreams.
HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet: Ein double, der Zugriff auf das Endzeitpunkt-Fragment bietet, wenn das Medienelement eine Fragment-URI für currentSrc hat, andernfalls ist es gleich der Gesamtdauer der Medien.

Instanz-Methoden

Diese Schnittstelle erbt auch Methoden von ihren 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 beeinflusst nicht das DOM.
HTMLMediaElement.captureStream(): Gibt MediaStream zurück und erfasst einen Stream des Medieninhalts.
HTMLMediaElement.canPlayType(): Angenommen, ein String spezifiziert einen MIME-Medientyp (möglicherweise mit dem codecs-Parameter enthalten), gibt canPlayType() den String probably zurück, wenn das Medium abgespielt werden sollte, maybe, wenn es nicht genug Informationen gibt, um festzustellen, 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.getStartDate(): Gibt ein Date-Objekt zurück, das das realweltliche Datum und die Zeit darstellt, die dem Beginn des Mediums entspricht. Bei Live-Streams ist dies die Zeit, als die Übertragung auf dem Server begann, was vor dem Beginn des Ansehens durch den Benutzer liegen kann.
HTMLMediaElement.load(): Setzt das Medium zum Anfang zurück und wählt die beste verfügbare Quelle aus den bereitgestellten Quellen über das src Attribut oder das <source> Element aus.
HTMLMediaElement.pause(): Pausiert die Medienwiedergabe.
HTMLMediaElement.play(): Startet 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 einer benutzerdefinierten Geschwindigkeit manuell zu steuern oder sich durch das Medium Bild für Bild zu bewegen, um Filter oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys() Sicherer Kontext: Gibt ein Promise zurück. Setzt die MediaKeys Schlüssel, die bei der Entschlüsselung von Medien während der Wiedergabe verwendet werden.
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 autorisiert 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: Das mit Firefox präfixierte Äquivalent von HTMLMediaElement.captureStream(). Siehe dessen 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 aus der abspielenden Medienquelle als {key: value} Paare darstellen. Jedes Mal, wenn die Methode aufgerufen wird, wird eine separate Kopie der Daten zurückgegeben. Diese Methode muss nach dem loadedmetadata Ereignis aufgerufen werden.

Ereignisse

Erbt Ereignisse von ihrem Elternteil, HTMLElement.

Sie können diesen Ereignissen mit addEventListener() lauschen oder einen Ereignis-Listener der oneventname-Eigenschaft dieser Schnittstelle zuweisen.

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, aber schätzt, dass nicht genug Daten geladen wurden, um das Medium bis zum Ende abzuspielen, ohne für weiteres Puffern der Inhalte anzuhalten.
canplaythrough: Wird ausgelöst, wenn der Benutzeragent das Medium abspielen kann und schätzt, dass genügend Daten geladen wurden, um das Medium bis zum Ende abzuspielen, ohne für weiteres Puffern der Inhalte anzuhalten.
durationchange: Wird ausgelöst, wenn die duration-Eigenschaft aktualisiert wurde.
emptied: Wird ausgelöst, wenn die Medien leer geworden sind; zum Beispiel, wenn Medien bereits geladen wurden (oder teilweise geladen) und die HTMLMediaElement.load()-Methode aufgerufen wird, um sie neu zu laden.
encrypted: Wird ausgelöst, wenn Initialisierungsdaten in den Medien gefunden werden, die darauf hinweisen, dass die Medien verschlüsselt sind.
ended: Wird 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: Wird ausgelöst, wenn die Ressource aufgrund eines Fehlers nicht geladen werden konnte.
loadeddata: Wird ausgelöst, wenn das erste Bild 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 ein Steuerungsbefehl Pause abzuspielen bearbeitet wurde und die Aktivität in ihren pausierten Zustand übergegangen ist. Dies geschieht am häufigsten, wenn die HTMLMediaElement.pause()-Methode des Mediums aufgerufen wird.
play: Wird ausgelöst, wenn die paused-Eigenschaft von true auf false geändert wurde, als Ergebnis der HTMLMediaElement.play()-Methode oder des autoplay Attributs.
playing: Wird ausgelöst, wenn die Wiedergabe bereit ist zu starten, nachdem sie pausiert war oder aufgrund von 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 zu holen, aber Daten unvorhergesehen nicht bereitgestellt werden.
suspend: Wird ausgelöst, wenn das Laden der Mediendaten unterbrochen wurde.
timeupdate: Wird ausgelöst, wenn der durch die currentTime-Eigenschaft angezeigte Zeitpunkt 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 zunächst blockiert wird während des Wartens auf einen Schlüssel.

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