TimeRanges
Beim Laden einer Medienressource zur Verwendung durch ein <audio>
- oder <video>
-Element wird die TimeRanges
-Schnittstelle zur Darstellung der Zeitbereiche der Medienressource verwendet, die gepuffert wurden, die abgespielt wurden und die verfügbar sind zum Suchen.
Ein TimeRanges
-Objekt umfasst einen oder mehrere Zeitbereiche, die jeweils durch einen Startzeitoffset und einen Endzeitoffset spezifiziert sind. Sie beziehen sich auf jeden Zeitbereich, indem Sie die Methoden start()
und end()
verwenden und die Indexnummer des Zeitbereichs übergeben, den Sie abrufen möchten.
Normalisierte TimeRanges-Objekte
Mehrere Mitglieder von HTMLMediaElement
-Objekten geben ein normalisiertes TimeRanges-Objekt zurück — das die Spezifikation beschreibt als mit den folgenden Eigenschaften:
Die Bereiche in einem solchen Objekt sind geordnet, überlappen sich nicht und berühren sich nicht (angrenzende Bereiche werden zu einem größeren Bereich zusammengefasst). Ein Bereich kann leer sein (bezieht sich nur auf einen einzelnen Zeitpunkt).
Instanz-Eigenschaften
TimeRanges.length
Nur lesbar-
Gibt ein
unsigned long
zurück, das die Anzahl der Zeitbereiche repräsentiert, die durch das Zeitbereichsobjekt dargestellt werden.
Instanz-Methoden
TimeRanges.start()
-
Gibt die Zeit für den Beginn des Bereichs mit dem angegebenen Index zurück.
TimeRanges.end()
-
Gibt die Zeit für das Ende des angegebenen Bereichs zurück.
Spezifikationen
Specification |
---|
HTML Standard # time-ranges |
Browser-Kompatibilität
BCD tables only load in the browser