Text tracks

addTextTrack() は HTMLMediaElement インターフェイスのメソッドで、新しい TextTrack オブジェクトを作成し、それをこのメディア要素に追加します。このメソッドは、 TextTrackList/addtrack_event イベントをこのメディア要素の HTMLMediaElement/textTracks で発行します。このメソッドは、 TextTrackList インターフェイスでは使用できません。 HTMLMediaElement でのみ使用できます。

HTMLTrackElement インターフェイスは DOM 内にある HTML の track 要素を表します。この要素は audio または video の子として使用され、クローズドキャプションや字幕などの情報を含むテキストトラックを指定することが可能です。

cuechange イベントは TextTrack が現在表示しているキューを変更した際に発生します。このイベントは TextTrack と、それが表示されている HTMLTrackElement があれば、その両方で発生します。

HTMLTrackElement インターフェースの default プロパティは、ユーザーの好みが他のトラックの方が適切であることを示していない場合に、トラックを有効にするかどうかを表します。これは track 要素の boolean default 属性を反映し、存在すれば真を、そうでなければ偽を返します。

HTMLTrackElement インターフェースの kind プロパティは、トラックの種類、つまりテキストトラックがどのように使われるかを表します。これは track 要素の列挙された kind 属性を反映します。

HTMLTrackElement の label プロパティは、トラックの字幕、キャプション、音声説明を一覧表示する際に表示される、ユーザーが読みやすいタイトルを表します。これは track 要素の label 属性を反映します。

HTMLTrackElement インターフェースの readyState 読み取り専用プロパティは、track 要素のテキストトラック準備状態を表す数値を返します：

HTMLTrackElement.src プロパティは、テキストトラックのデータの URL を示す track 要素の src 属性の値を反映したものです。

HTMLTrackElement インターフェースの srclang プロパティは、track 要素の srclang 属性の値を反映します。

HTMLTrackElement インターフェースの track 読み取り専用プロパティは、track 要素のテキストトラックに対応する TextTrack オブジェクトを返します。

TextTrack インターフェイスは — WebVTT (メディア表示上のテキストトラック) を扱う API の一部ですが — 特定の track 要素に関連付けられたテキストトラックを記述および制御します。

activeCues は TextTrack インターフェイスの読み取り専用プロパティで、現在アクティブなキューを列挙した TextTrackCueList オブジェクトを返します。

addCue() は TextTrack インターフェイスのメソッドで、新しいキューをキューのリストへ追加します。

cuechange イベントは、 TextTrack が現在表示しているキューが変更されたときに発生します。このイベントは、表示されているものがあれば、 TextTrack および HTMLTrackElement の両方に発生します。

cues は TextTrack インターフェイスの読み取り専用プロパティで、トラックのこのすべてのキューが入った TextTrackCueList オブジェクトを返します。

id は TextTrack インターフェイスの読み取り専用プロパティで、このトラックの ID があれば、それを返します。

inBandMetadataTrackDispatchType は TextTrack インターフェイスの読み取り専用プロパティで、この TextTrack オブジェクトが表すテキストトラックの帯域内メタデータディスパッチ種別を返します。

kind は TextTrack インターフェイスの読み取り専用プロパティで、このオブジェクトが表すテキストトラックの種類を返します。 これは、ユーザーエージェントがトラックをどのように処理するかを決定します。

label は TextTrack インターフェイスの読み取り専用プロパティで、このテキストトラックの人間可読なラベルがあれば、それを返します。

language は TextTrack インターフェイスの読み取り専用プロパティで、このテキストトラックの言語を返します。

TextTrack インターフェイスの mode プロパティは、テキストトラックのモードを指定して制御する disabled, hidden, showing のいずれかの文字列です。この値を読み取って現在のモードを決定したり、この値を変更してモードを切り替えることができます。

removeCue() は TextTrack インターフェイスのメソッドで、キューのリストからキューを取り除きます。

TextTrackCue は抽象クラスで、 VTTCue などの派生キュー型の基礎として使用されます。代わりに、これらの派生型を使用して作業することになります。これらのキューは、 TextTrack の再生中にある時間だけ表示される文字列を表します。キューには、開始時刻（テキストが表示される時刻）と終了時刻（テキストが表示されなくなる時刻）、およびその他の情報を記載します。

endTime は TextTrackCue インターフェイスのプロパティで、キューの終了時刻を返したり設定したりします。

enter イベントは、キューがアクティブになったときに発行されます。字幕やキャプションの場合、メディア上に表示されるタイミングです。

exit イベントは、キューがアクティブでなくなったときに発行されます。

id は TextTrackCue インターフェイスのプロパティで、このキューの識別子を返したり設定したりします。

pauseOnExit は TextTrackCue インターフェイスのプロパティで、このキューが適用される範囲の終わりに達したとき、メディアの再生を一時停止すべきかどうかを示すフラグを返したり設定したりします。

startTime は TextTrackCue インターフェイスのプロパティで、このキューの開始時刻を返したり設定したりします。

track は TextTrackCue インターフェイスの読み取り専用プロパティで、このキューが所属する TextTrack オブジェクトを返します。

TextTrackCueList は配列風オブジェクトで、動的に更新される TextTrackCue オブジェクトのリストを表します。

getCueById() は TextTrackCueList インターフェイスのメソッドで、TextTrackCueList オブジェクトが表すリストの中で、識別子が id の値と一致する最初の VTTCue を返します。

length は TextTrackCueList インターフェイスの読み取り専用プロパティで、リスト中のキューの数を返します。

TextTrackListインターフェイスは、関連するビデオまたはオーディオ要素に定義されたテキストトラックのリストを表すために使用され、各トラックはリスト内の別々のTextTrackオブジェクトによって表されます。

addtrackイベントは、TextTrackListにトラックが追加されたときに発生します。

changeイベントは、テキストトラックがアクティブまたは非アクティブになったとき、またはTextTrackListが変更されたときに発生します。

TextTrackList メソッド getTrackById() は、トラックリストから、指定された文字列と ID が一致する最初の TextTrack オブジェクトを返します。これにより、ID 文字列がわかっていれば、指定されたトラックを見つけることができます。

読み取り専用のTextTrackListプロパティのlengthは、TextTrackListのエントリ数を返し、各エントリはメディア要素の1トラックを表すTextTrackである。

removetrack イベントは、TextTrackList からトラックが削除されたときに発生します。

は HTML の要素で、メディア要素 (audio および video) の子として使用します。この要素は自動的に処理される字幕など、時間指定されたテキストトラック (または時系列データ) を指定することができます。トラックは WebVTT 形式 (.vtt ファイル) を用います。