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.

Das HTMLMediaElement-Interface fügt dem HTMLElement die Eigenschaften und Methoden hinzu, die für grundlegende medienbezogene Funktionen erforderlich sind, die für Audio und Video üblich sind.

Die HTMLVideoElement und HTMLAudioElement Elemente erben beide dieses Interface.

Instanzeigenschaften

Dieses Interface erbt auch Eigenschaften von seinen 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 autoplay HTML-Attribut widerspiegelt und anzeigt, ob die Wiedergabe automatisch beginnen soll, sobald genügend Medien vorhanden sind, um dies ohne Unterbrechung zu tun.

Hinweis: Das automatische Abspielen von Audio, wenn der Benutzer es nicht erwartet oder wünscht, ist ein schlechtes Benutzererlebnis und sollte in den meisten Fällen vermieden werden, obwohl es Ausnahmen gibt. Siehe den Leitfaden zur automatischen Wiedergabe für Medien und Web Audio APIs für weitere Informationen. Beachten Sie, dass Browser möglicherweise Autoplay-Anfragen ignorieren, daher sollten Sie sicherstellen, dass Ihr Code nicht von der Funktion des Autoplays abhängig ist.
HTMLMediaElement.buffered Schreibgeschützt: Gibt ein TimeRanges-Objekt zurück, das die Bereiche der Medienquelle angibt, die der Browser (falls vorhanden) zum Zeitpunkt des Zugriffs auf die buffered-Eigenschaft zwischengespeichert hat.
HTMLMediaElement.controls: Ein boolescher Wert, der das controls HTML-Attribut widerspiegelt und anzeigt, ob Bedienungselemente für die Steuerung der Ressource angezeigt werden sollen.
HTMLMediaElement.controlsList: Gibt eine DOMTokenList zurück, die dem Benutzeragenten dabei hilft, welche Steuerungen auf dem Medienelement angezeigt werden sollen, wann immer der Benutzeragent seine eigenen Steuerelemente zeigt. Die DOMTokenList nimmt einen oder mehrere der drei möglichen Werte an: 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 doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt; wenn das Medium noch nicht abgespielt wurde und nicht gesucht wurde, ist dieser Wert die Anfangswiedergabezeit des Mediums. Das Setzen dieses Wertes sucht das Medium zur neuen Zeit. Die Zeit wird relativ zur Medienzeitleiste angegeben.
HTMLMediaElement.defaultMuted: Ein boolescher Wert, der das muted HTML-Attribut widerspiegelt, das angibt, ob die Audioausgabe des Medienelements standardmäßig stummgeschaltet werden soll.
HTMLMediaElement.defaultPlaybackRate: Ein double, der die Standardwiedergabegeschwindigkeit für die Medien angibt.
HTMLMediaElement.disableRemotePlayback: Ein boolescher Wert, der den Zustand der Remote-Wiedergabe setzt oder zurückgibt und angibt, ob das Medienelement eine Remote-Wiedergabe-Benutzeroberfläche haben darf.
HTMLMediaElement.duration Schreibgeschützt: Ein schreibgeschützter Gleitkommawert doppelter Genauigkeit, der die Gesamtdauer 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 z.B. gestreamte Live-Medien, ein WebRTC-Anrufmedium 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.loading: Ein String, der angibt, ob der Browser die Medien sofort (eager) oder bei Bedarf (lazy) laden soll. Siehe <video loading> und <audio loading> HTML-Attribute für weitere Informationen.
HTMLMediaElement.loop: Ein boolescher Wert, der das loop HTML-Attribut widerspiegelt und 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 ein Satz von Schlüsseln ist, die 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 festlegt, ob Audio stummgeschaltet ist. true, wenn das Audio stummgeschaltet ist und false andernfalls.
HTMLMediaElement.networkState Schreibgeschützt: Gibt ein unsigned short (Enumeration) zurück, das den aktuellen Zustand des Abrufs der Medien ü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, der die Wiedergabegeschwindigkeit 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, sofern 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 beibehalten wird. Wenn auf false gesetzt, passt sich die Tonhöhe der Geschwindigkeit des Audios an.
HTMLMediaElement.readyState Schreibgeschützt: Gibt ein unsigned short (Enumeration) zurück, das den Bereitschaftszustand der Medien anzeigt.
HTMLMediaElement.remote Schreibgeschützt: Gibt ein RemotePlayback-Objektinstanz zurück, die 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 dabei sind, zu einer neuen Position zu springen.
HTMLMediaElement.sinkId Schreibgeschützt Sicherer Kontext: Gibt einen String zurück, der die eindeutige ID des Audiogeräts ist, 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 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 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, das angibt, zu welcher Gruppe von Elementen es gehört. Eine Gruppe von Medienelementen teilt sich einen gemeinsamen MediaController.
HTMLMediaElement.mozAudioCaptured Schreibgeschützt Nicht standardisiert Veraltet: Gibt einen booleschen Wert zurück. Im Zusammenhang mit der Aufnahme von Audioströmen.
HTMLMediaElement.mozFragmentEnd Nicht standardisiert Veraltet: Ein double, das den Zugriff auf die Fragment-Endzeit ermöglicht, wenn das Medienelement eine Fragment-URI für currentSrc hat, andernfalls entspricht es der Medienlänge.

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 ausschließlich eine programmgesteuerte Schnittstelle und hat keine Auswirkungen auf das DOM.
HTMLMediaElement.captureStream(): Gibt MediaStream zurück, erfasst einen Stream des Medieninhalts.
HTMLMediaElement.canPlayType(): Gibt für einen String, der einen MIME-Medientyp spezifiziert (möglicherweise mit dem codecs-Parameter enthalten), den String probably zurück, wenn die Medien wahrscheinlich abgespielt werden können, maybe, wenn nicht genügend Informationen vorhanden sind, um festzustellen, ob die Medien abgespielt werden oder nicht, oder einen leeren String, wenn die Medien nicht abgespielt werden können.
HTMLMediaElement.fastSeek(): Springt schnell zur angegebenen Zeit mit geringer Präzision.
HTMLMediaElement.getStartDate(): Gibt ein Date-Objekt zurück, das das reale Datum und die Uhrzeit darstellt, die dem Beginn der Medien entsprechen. Bei Live-Streams ist dies die Zeit, zu der die Übertragung auf dem Server begann, was vor dem Zeitpunkt liegen kann, als der Benutzer mit dem Ansehen begann.
HTMLMediaElement.load(): Setzt die Medien an den Anfang zurück und wählt die beste verfügbare Quelle aus den mit dem src-Attribut oder dem <source>-Element bereitgestellten Quellen aus.
HTMLMediaElement.pause(): Pausiert die Medienwiedergabe.
HTMLMediaElement.play(): Startet die Wiedergabe der Medien.
HTMLMediaElement.seekToNextFrame() Veraltet Nicht standardisiert: Springt zum nächsten Frame in den Medien. Diese nicht standardisierte und experimentelle Methode macht es möglich, das Lesen und Rendern von Medien mit einer benutzerdefinierten Geschwindigkeit manuell zu steuern oder Frame für Frame durch die Medien zu gehen, um Filterungen oder andere Operationen durchzuführen.
HTMLMediaElement.setMediaKeys() Sicherer Kontext: Gibt Promise zurück. Setzt die beim Entschlüsseln von Medien während der Wiedergabe zu verwendenden MediaKeys-Schlüssel.
HTMLMediaElement.setSinkId() Sicherer Kontext: Setzt die ID des für die Ausgabe zu verwendenden Audiogeräts 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, selbst wenn ein Browser sie noch unterstützt.

HTMLMediaElement.mozCaptureStream() Nicht standardisiert: Das Firefox-präfixierte Äquivalent von HTMLMediaElement.captureStream(). Siehe seine Browser-Kompatibilität für Details.
HTMLMediaElement.mozCaptureStreamUntilEnded() Nicht standardisiert Veraltet: Eine nicht standardisierte, veraltete, Methode, um den Stream bis zu seinem Ende zu erfassen.
HTMLMediaElement.mozGetMetadata() Nicht standardisiert Veraltet: Gibt Object zurück, das Eigenschaften enthält, die Metadaten aus der wiedergegebenen Medienressource 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.

Events

Erbt Events von seinem Elternteil, HTMLElement.

Hören Sie auf diese Events, indem Sie addEventListener() verwenden oder indem Sie einen Event-Listener der oneventname-Eigenschaft dieses Interfaces 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 die Medien abspielen kann, aber schätzt, dass nicht genügend Daten geladen wurden, um die Medien bis zum Ende abzuspielen, ohne weiteres Puffern von Inhalten.
canplaythrough: Wird 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 weiteres Puffern von Inhalten.
durationchange: Wird ausgelöst, wenn die Eigenschaft duration aktualisiert wurde.
emptied: Wird ausgelöst, wenn die Medien leer geworden sind; zum Beispiel, wenn die Medien bereits geladen (oder teilweise geladen) wurden 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 gestoppt wird, 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 der erste Frame der Medien 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 Anfrage zum Anhalten der Wiedergabe bearbeitet wird und die Aktivität ihren pausierten Zustand erreicht hat, am häufigsten, wenn die HTMLMediaElement.pause()-Methode des Mediums aufgerufen wird.
play: Wird ausgelöst, wenn die paused-Eigenschaft von true zu 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 Verzögerung aufgrund von fehlenden Daten bereit zum Starten ist.
progress: Wird periodisch ausgelöst, während der Browser eine Ressource lädt.
ratechange: Wird ausgelöst, wenn die Wiedergabegeschwindigkeit geändert wurde.
seeked: Wird ausgelöst, wenn eine Suchoperation abgeschlossen ist.
seeking: Wird ausgelöst, wenn eine Suchoperation beginnt.
stalled: Wird ausgelöst, wenn der Benutzeragent versucht, Mediendaten zu holen, diese aber unerwartet nicht kommen.
suspend: Wird ausgelöst, wenn das Laden der Mediendaten ausgesetzt wurde.
timeupdate: Wird ausgelöst, wenn die durch die currentTime-Eigenschaft angegebene Zeit aktualisiert wurde.
volumechange: Wird ausgelöst, wenn die Lautstärke geändert wurde.
waiting: Wird ausgelöst, wenn die Wiedergabe gestoppt wurde, weil vorübergehend keine Daten verfügbar sind.
waitingforkey: Wird ausgelöst, wenn die Wiedergabe das erste Mal blockiert ist, 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