VTTCue: VTTCue() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der VTTCue() Konstruktor erstellt und gibt ein neues VTTCue-Objekt zurück.

Syntax

js
new VTTCue(startTime, endTime, text)

Parameter

startTime

Dies ist ein double, das die Anfangszeit der Text-Track-Cue darstellt. Dies ist die Zeit, angegeben in Sekunden und Bruchteilen von Sekunden, die den Beginn des Bereichs der Mediendaten angibt, auf die dieser Cue zutrifft. Zum Beispiel, wenn ein Cue von 50 Sekunden bis eine Minute, fünf und eine halbe Sekunde in der Medienwiedergabe sichtbar sein soll, wird startTime 50.0 sein.

endTime

Dies ist ein double, das die Endzeit für diesen Text-Track-Cue darstellt. Dies ist die Zeit, zu der der Cue der Nutzerin oder dem Nutzer nicht mehr präsentiert werden soll, angegeben in Sekunden und deren Bruchteilen. Für das unter startTime erwähnte Beispiel-Cue wäre der Wert von endTime 65.5.

text

Ein String, der den Text bereitstellt, der während des Zeitraums angezeigt wird, der durch startTime und endTime angegeben ist.

Rückgabewert

Ein neues VTTCue-Objekt, das einen Cue darstellt, der während des angegebenen Zeitraums präsentiert wird.

Beispiele

js
// Create a cue that is shown from 2 to 3 seconds and uses the given text.
let cue = new VTTCue(2, 3, "Cool text to be displayed");

Spezifikationen

Specification
WebVTT: The Web Video Text Tracks Format
# dom-vttcue-vttcue

Browser-Kompatibilität

BCD tables only load in the browser