VTTCue: VTTCue() コンストラクター

Baseline Widely available

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

VTTCue() コンストラクターは新しい VTTCue オブジェクトを返します。

構文

js
new VTTCue(startTime, endTime, text)

引数

startTime

最初のテキストトラックのキュー開始時刻を表す double です。 これは、秒と秒の小数で指定された時刻で、このキューが適用されるメディアデータの範囲の開始時刻を表します。例えば、 50 秒から 1 分 5.5 秒までのキューを表示する場合、 startTime は 50.0 になります。

endTime

このテキストトラックのキュー終了時刻を表す double です。 これは、キューをユーザーに表示するのを止める時刻を指定された秒と秒の小数で表したものです。startTime で示したキューの例では、endTime の値は 65.5 となります。

text

startTimeendTime で示される時刻の間に表示させる、テキストを指定する文字列です。

返値

指定された時刻の間に表示されるキューを表す新しい VTTCue オブジェクトです。

js
// 2 ~ 3 秒の間に表示するキューを作成し、指定されたテキストを使用します。
let cue = new VTTCue(2, 3, "かっこいい文章を表示する");

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser