HTMLMediaElement: currentTime-Eigenschaft
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.
Die currentTime-Eigenschaft des HTMLMediaElement-Interfaces gibt die aktuelle Wiedergabezeit in Sekunden an.
Das Ändern des Wertes von currentTime springt das Medium zur neuen Zeit.
Wert
Ein Gleitkomma-Doppelpräzisionswert, der die aktuelle Wiedergabezeit in Sekunden angibt.
Wenn das Medium noch nicht spielt, zeigt der Wert von currentTime die Zeitposition innerhalb des Mediums an, bei der die Wiedergabe beginnt, sobald die play()-Methode aufgerufen wird.
Das Setzen von currentTime auf einen neuen Wert springt das Medium zur angegebenen Zeit, sofern das Medium verfügbar ist.
Bei Medien ohne bekannte Dauer – wie z.B. live gestreamte Medien – ist es möglich, dass der Browser Teile des Mediums nicht mehr abrufen kann, die aus dem Mediabuffer entfernt wurden. Auch Medien, deren Zeitachse nicht bei 0 Sekunden beginnt, können nicht zu einer Zeit vor dieser frühesten Zeit der Zeitachse gesprungen werden.
Die Länge des Mediums in Sekunden kann mit der duration-Eigenschaft bestimmt werden.
Beispiele
const video = document.createElement("video");
console.log(video.currentTime);
Hinweise zur Verwendung
Zeitpräzision
Der Browser wendet keine Timer-Rundung auf currentTime an, einschließlich Werte, die durch Skripte bereitgestellt werden. Das Springen kann die resultierende Wiedergabeposition dennoch auf eine von dem Medium unterstützte Position anpassen.
Der Wert von currentTime ist eine Annäherung an die aktuelle Wiedergabeposition. Der Browser aktualisiert diesen Wert, während die Wiedergabe fortschreitet. Die HTML-Spezifikation erfordert, dass die gemeldete Wiedergabeposition stabil bleibt, während Skripte ausgeführt werden.
Die Aktualisierungsfrequenz hängt vom Browser und der Medienwiedergabepipeline ab. Daher können aufeinanderfolgende Abfragen denselben currentTime zurückgeben, auch wenn Date.now() vorangeschritten ist. Die Anzahl der Dezimalstellen im Wert zeigt nicht an, wie oft er aktualisiert wird oder wie genau er mit dem präsentierten Audio oder Video übereinstimmt.
Zum Beispiel könnten aufeinanderfolgende Abfragen während der Wiedergabe diese Werte liefern:
video.currentTime;
// Might be:
// 23.404
// 23.404
// 23.452
// …
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-media-currenttime-dev |
Browser-Kompatibilität
Siehe auch
HTMLMediaElement: Interface zur Definition derHTMLMediaElement.currentTime-EigenschaftHTMLMediaElement.fastSeek(): Eine andere Methode, um die Zeit einzustellenHTMLMediaElement.duration: Die Dauer des Mediums in Sekunden