HTML — track 要素

4.8.11.11.1. ~tT~model

各`~media要素$は、 `~tT~list@ を有する — それは， `~tT@ たちが成す~groupであり、 次に挙げる順に~sortされる： ◎ A media element can have a group of associated text tracks, known as the media element's list of text tracks. The text tracks are sorted as follows:

1. `~media要素$の子である各 `track$e 要素に対応する`~tT$たち — `~tree順序$で。 ◎ The text tracks corresponding to track element children of the media element, in tree order.
2. `addTextTrack()$mM ~methodを利用して追加された`~tT$たち — それらが追加された順序で。 ◎ Any text tracks added using the addTextTrack() method, in the order they were added, oldest first.
3. `~media資源に特有な~tT$ （`~media資源$内の~dataに対応する`~tT$）たち — `~media資源$の形式~仕様に定義される順序で。 ◎ Any media-resource-specific text tracks (text tracks corresponding to data in the media resource), in the order defined by the media resource's format specification.

各`~tT$ %~tT は、 次に挙げるものからなる： ◎ A text track consists of:

`種類@tT ◎ The kind of text track

~UAが %~tT をどう取扱うか裁定する。 ◎ This decides how the track is handled by the user agent.＼

種類は、 次に挙げるいずれかの文字列で表現される ⇒＃ `subtitles@l, `captions@l, `descriptions@l, `chapters@l, `metadata@l ◎ The kind is represented by a string. The possible strings are: • subtitles • captions • descriptions • chapters • metadata

%~tT が ある `track$e 要素に対応する事例では、 `種類$tTは動的に変化し得る。 ◎ The kind of track can change dynamically, in the case of a text track corresponding to a track element.

`~label@tT ◎ A label

ヒトが読める文字列 — 利用者が %~tT を識別するために意図される。 ◎ This is a human-readable string intended to identify the track for the user.

%~tT が ある `track$e 要素に対応する事例では、 `~label$tTは動的に変化し得る。 ◎ The label of a track can change dynamically, in the case of a text track corresponding to a track element.

~UAは，`~label$tTが空~文字列のときは、［ 自身の~UIにおける利用-用に適切な~label ］を %~tT の他の~prop（例： %~tT の`種類$tTや`言語$tT）から自動的に生成するベキである。 この自動的に生成される~labelは、 ~APIには公開されない。 ◎ When a text track label is the empty string, the user agent should automatically generate an appropriate label from the text track's other properties (e.g. the kind of text track and the text track's language) for use in its user interface. This automatically-generated label is not exposed in the API.

`帯域内~metadata~track配送~型@ ◎ An in-band metadata track dispatch type

`~media資源$から抽出された文字列 — 特定的には、 帯域内~metadata~track用に［ そのような~trackが文書~内の異なる~scriptへ配送される ］ことを可能化するためにある。 ◎ This is a string extracted from the media resource specifically for in-band metadata tracks to enable such tracks to be dispatched to different scripts in the document.

例えば，~web上で~stream化され，~webに特有な対話的~特能で増補された伝統的な~TV局の放送は、［ ~~広告, ~game~showの間における~trivia~game~data, ~sports~gameの間における~playerの状態, 料理番組の間における~recipe情報, 等々 ］用の~metadataを伴う~tTを含み得る。 各 番組が［ 開始するに伴い，新たな~trackが追加される／ 終止するに伴い，~trackが~streamから除去される ］こともある — ~UAは、 各~trackが追加されるに伴い，［ この属性の値を利用して，それを専用の~script~moduleに束縛する ］こともできる。 ◎ For example, a traditional TV station broadcast streamed on the web and augmented with web-specific interactive features could include text tracks with metadata for ad targeting, trivia game data during game shows, player states during sports games, recipe information during food programs, and so forth. As each program starts and ends, new tracks might be added or removed from the stream, and as each one is added, the user agent could bind them to dedicated script modules using the value of this attribute.

%~tT が帯域内~metadata用でない場合、 `帯域内~metadata~track配送~型$は空~文字列とする。 この値が異なる~media形式~用にどう拡充されるかは、 `~media資源に特有な~tTを公開する手続き$にて述べられる。 ◎ Other than for in-band metadata text tracks, the in-band metadata track dispatch type is the empty string. How this value is populated for different media formats is described in steps to expose a media-resource-specific text track.

`言語@tT ◎ A language

%~tT の~cueたちを成す言語を表現している文字列 （ BCP 47 言語~tag）。 `BCP47$r ◎ This is a string (a BCP 47 language tag) representing the language of the text track's cues. [BCP47]

%~tT が ある `track$e 要素に対応する事例では、 `言語$tTは動的に変化し得る。 ◎ The language of a text track can change dynamically, in the case of a text track corresponding to a track element.

`準備度@tT ◎ A readiness state

次に挙げるいずれか： ◎ One of the following:

`未読込み@i ◎ Not loaded

%~tT の~cueたちは，まだ得されていないことを指示する。 ◎ Indicates that the text track's cues have not been obtained.

`読込中@i ◎ Loading

%~tT は読込中にあり，これまで致命的な~errorには遭遇していないことを指示する。 ~trackには、 構文解析器により，更に~cueが追加されるかもしれない。 ◎ Indicates that the text track is loading and there have been no fatal errors encountered so far. Further cues might still be added to the track by the parser.

`読込済み@i ◎ Loaded

%~tT は致命的~errorを伴わずに読込まれたことを指示する。 ◎ Indicates that the text track has been loaded with no fatal errors.

`読込失敗@i ◎ Failed to load

%~tT は可能化されたが、 ~UAがそれを得するよう試みたとき，何らかの仕方で失敗したことを指示する （例： `~URLを符号化法の下で相対的に構文解析する$のに失敗した ／ ~network~error／ %~tT の形式は未知である）。 その~cueたちのうち一部または全部は、 欠落って得されない見込みが高い。 ◎ Indicates that the text track was enabled, but when the user agent attempted to obtain it, this failed in some way (e.g., URL could not be parsed, network error, unknown text track format). Some or all of the cues are likely missing and will not be obtained.

%~tT の`準備度$tTは、 それが得されるに伴い，動的に変化する。 ◎ The readiness state of a text track changes dynamically as the track is obtained.

`~mode@tT ◎ A mode

次に挙げるいずれか： ◎ One of the following:

`~disabled@i （不能化されている） ◎ Disabled

%~tT は作動中でないことを指示する。 ~DOM内の~trackを公開する目的~以外においては、 ~UAは %~tT を無視する。 作動中になる~cueは無く, 発火される~eventは無く, ~UAは~cueを得するよう試みないことになる。 ◎ Indicates that the text track is not active. Other than for the purposes of exposing the track in the DOM, the user agent is ignoring the text track. No cues are active, no events are fired, and the user agent will not attempt to obtain the track's cues.

`~hidden@i （隠されている） ◎ Hidden

%~tT は作動中であるが、 ~UAは その~cueは作動化して表示していないことを指示する。 ~trackの~cueを得するよう試みは，まだ為されていない場合、 ~UAは，直ちにそれを遂行することになる。 ~UAは、［ 作動中であって，それに則って~eventが発火されることになる，~cueたち ］が成す~listを保守している。 ◎ Indicates that the text track is active, but that the user agent is not actively displaying the cues. If no attempt has yet been made to obtain the track's cues, the user agent will perform such an attempt momentarily. The user agent is maintaining a list of which cues are active, and events are being fired accordingly.

`~showing@i （示している） ◎ Showing

%~tT は作動中であることを指示する。 ~trackの~cueを得するよう試みは，まだ為されていない場合、 ~UAは，直ちにそれを遂行することになる。 ~UAは［ 作動中であって，それに則って~eventが発火されることになる，~cueたち ］が成す~listを保守している。 加えて， %~tT の`種類$tTに応じて：

• `subtitles$l ／ `captions$l ⇒ ~cueたちは動画~上に適切に積層されている
• `descriptions$l ⇒ ~UAは、 利用者~向けに~cueたちを視覚的でない流儀で可用にしている
• `chapters$l ⇒ ~UAは、 次のような仕組みで，利用者~向けに~cueたちを可用にしている ⇒ 利用者は、 ある~cueを選定することにより，`~media資源$内のどの地点にも~navigateできる

◎ Indicates that the text track is active. If no attempt has yet been made to obtain the track's cues, the user agent will perform such an attempt momentarily. The user agent is maintaining a list of which cues are active, and events are being fired accordingly. In addition, for text tracks whose kind is subtitles or captions, the cues are being overlaid on the video as appropriate; for text tracks whose kind is descriptions, the user agent is making the cues available to the user in a non-visual fashion; and for text tracks whose kind is chapters, the user agent is making available to the user a mechanism by which the user can navigate to any point in the media resource by selecting a cue.

`~cue~list@tT ◎ A list of zero or more cues

`~cue$たちが成す~list。 ◎ A list of text track cues,＼ ↓along with rules for updating the text track rendering. For example, for WebVTT, the rules for updating the display of WebVTT text tracks. [WEBVTT]

`~cue~list$tTの内容は、 %~tT の`準備度$tTが まだ［ `未読込み$i ／ `読込中$i ］にある間に, あるいは~DOM操作に因り，動的に変化し得る。 ◎ The list of cues of a text track can change dynamically, either because the text track has not yet been loaded or is still loading, or due to DOM manipulation.

（`~cue~list$tTを成す各~cueの） `具現化を更新するための規則@

例えば，~WebVTT用には、 `~WebVTT~tTの表示を更新するための規則$になる。 `WEBVTT$r ◎ ↑

【 何を入力にとり, 何を行うことになるか，などの具体的な詳細は、 この仕様には述べられていない。 【！（`~media要素$に関係するどこかの節で，間接的に何か述べている箇所はあるかもしれないが）】 また，原文では`~cue~list$tTに結付けられるが、 常に`~tT$を介して~accessされるので，この訳では直に~tTに結付けるよう単純~化している。 】

各`~tT$には、 それを表現している `TextTrack$I ~objがある。 【一対一に対応する。】 ◎ Each text track has a corresponding TextTrack object.

`~media要素$の`~tT$が `準備済み@i であるとは、 次を満たすことをいう ⇒ ［ その`処理待ち~tT~list$は空である ］~AND［ その`構文解析器にて阻まれているか$ ~EQ ~F ］ ◎ The text tracks of a media element are ready when both the element's list of pending text tracks is empty and the element's blocked-on-parser flag is false.

各`~media要素$は `~tT変更~通知は処理待ちか@ を有する — 初期~時は ~F をとるモノトスル。 ◎ Each media element has a pending text track change notification flag, which must initially be unset.

この節に挙げた`~task$用の`~task~source$は、 `~DOM操作~task~source$とする。 【と記されているが、明示的に`~media要素~event~task~source$を利用するよう更新されている。】 ◎ The task source for the tasks listed in this section is the DOM manipulation task source.

`~cue@ （ `text track cue^en †）は、 特定0の時刻に現れて，別の時刻に消える~text — 一例として，字幕／~caption用のそれ — に対応する，［ `~tT$内の時間に感応する~data ］が成す単位である。 ◎ A text track cue is the unit of time-sensitive data in a text track, corresponding for instance for subtitles and captions to the text that appears at a particular time and disappears at another time.

【† この訳では、 一律に “~cue” と略記する（他の複合語も含めて）。 “~tT用の~cueでない~cue” は、 この~pageには現れない。 】【 ~cueは，カタカナで記すと `queue^en の訳 “キュー” と同じ表記になるので、 この訳では原語のまま記すことにする。 】

各`~cue$は、 次に挙げるものからなる： ◎ Each text track cue consists of:

`識別子@tC ◎ An identifier

任意な文字列。 ◎ An arbitrary string.

`開始~時刻@tC ◎ A start time

~cueが適用される`~media~data$の範囲が始まる時刻を小数も伴い得る秒数で述べる。 ◎ The time, in seconds and fractions of a second, that describes the beginning of the range of the media data to which the cue applies.

`終了~時刻@tC ◎ An end time

~cueが適用される`~media~data$の範囲が終端する時刻を小数も伴い得る秒数で述べる — ただし、 `無限界な~cue$に対しては，正な `Infinity^jv になる。 ◎ The time, in seconds and fractions of a second, that describes the end of the range of the media data to which the cue applies, or positive Infinity for an unbounded text track cue.

`退出-時に静止するか@tC ◎ A pause-on-exit flag

~cueが適用される範囲の終端に達したとき、 `~media資源$の再生は静止するかどうかを指示する真偽値。 ◎ A boolean indicating whether playback of the media resource is to pause when the end of the range to which the cue applies is reached.

形式に特有な何らかの追加的な~data ◎ Some additional format-specific data

形式~用の必要に応じて、 追加的な~field — ~cueを成す実際の~dataを含めて。 例えば，~WebVTTには、 ~cueの`書字~方向＠~WEBVTT#webvtt-cue-writing-direction$, 等々がある。 `WEBVTT$r ◎ Additional fields, as needed for the format, including the actual data of the cue. For example, WebVTT has a text track cue writing direction and so forth. [WEBVTT]

`無限界な~cue@ （ `unbounded text track cue^en ）とは、 `終了~時刻$tCが正な `Infinity^jv に設定された`~cue$を指す。 作動中な`無限界な~cue$は、 通常の再生の間に，`現在の再生~位置$の通例的な単調増加を通して作動中でなくなることはない （例：終了~時刻が公告されていない［ ある~live0~event内の~chapter ］用の~metadata~cue）。 ◎ An unbounded text track cue is a text track cue with a text track cue end time set to positive Infinity. An active unbounded text track cue cannot become inactive through the usual monotonic increase of the current playback position during normal playback (e.g. a metadata cue for a chapter in a live event with no announced end time.)

［ `開始~時刻$tC／`終了~時刻$tC ］は、 負にもなり得る （`現在の再生~位置$は負になり得ないので、 終了~時刻が負な~cueは作動中になり得ないが）。 ◎ The text track cue start time and text track cue end time can be negative. (The current playback position can never be negative, though, so cues entirely before time zero cannot be active.)

各`~cue$には、 対応する `TextTrackCue$I ~objがある （より特定的には、 `TextTrackCue$I を継承する~obj — 例えば，~WebVTT~cueは、 `VTTCue$I ~interfaceを利用する `WEBVTT$r ）。 `~cue$の~memory内での表現は、 この `TextTrackCue$I ~APIを通して動的に変化し得る。 ◎ Each text track cue has a corresponding TextTrackCue object (or more specifically, an object that inherits from TextTrackCue — for example, WebVTT cues use the VTTCue interface). A text track cue's in-memory representation can be dynamically changed through this TextTrackCue API. [WEBVTT]

各`~cue$には、 `具現化を更新するための規則$が結付けられる — それは、 ~cueの種類ごとに，それ用の仕様により定義される。 この規則は、 当の~cueを表現している~objが［ `addCue()$tt ~methodを利用して `TextTrack$I ~objに追加される ］ときに，特定的に利用される。 ◎ A text track cue is associated with rules for updating the text track rendering, as defined by the specification for the specific kind of text track cue. These rules are used specifically when the object representing the cue is added to a TextTrack object using the addCue() method.

加えて、 各`~cue$は，次に挙げる動的な情報も有する： ◎ In addition, each text track cue has two pieces of dynamic information:

`作動中か@tC ◎ The active flag

初期~時は ~F になるモノトスル。 ◎ This flag must be initially unset.＼

これは、 次を確保するために利用される ⇒ 当の~cueが［ 作動中になる／作動中でなくなる ］とき、 ~eventが適切に発火され，常に的確な~cueが具現化される ◎ The flag is used to ensure events are fired appropriately when the cue becomes active or inactive, and to make sure the right cues are rendered.

当の~cueが ある`~tT$ %~tT の`~cue~list$tT %~cue~list を成している下で， 次が生じたときは、 同期的に ~F にするモノトスル：

• %~cue~list から当の~cueが除去されたとき
• %~tT の`~mode$tTが `~disabled$i に変化したとき

• さらに， %~tT が［ ある`~media要素$ %要素 の`~tT~list$ %~list ］を成している下で：

  • %~tT が %~list から除去されたとき
  • %要素 の `readyState$mM が `HAVE_NOTHING$mM へ戻るよう変化したとき

◎ The user agent must synchronously unset this flag＼ whenever the text track cue is removed from its text track's text track list of cues;＼ whenever the text track itself is removed from its media element's list of text tracks or＼ has its text track mode changed to disabled;＼ and whenever the media element's readyState is changed back to HAVE_NOTHING.＼

上に挙げた~~出来事により，［ 1 個以上の`~cue$の`作動中か$tCが， ~F に変化した ］ときは、 ~UAは — そうなる~cueすべてが，そうなった後に — ~AND↓ を満たす各`~tT$に対し…

• その`~mode$tTは、 ~~出来事の直前においては `~showing$i であった
• その`~cue~list$tTは、 変化したいずれかの~cueを含む

…その`具現化を更新するための規則$ — 例えば、 ~WebVTTに基づく`~tT$用には`~WebVTT~tTの表示を更新するための規則$ — を適用するモノトスル。 `WEBVTT$r

◎ When the flag is unset in this way for one or more cues in text tracks that were showing prior to the relevant incident, the user agent must, after having unset the flag for all the affected cues, apply the rules for updating the text track rendering of those text tracks. For example, for text tracks based on WebVTT, the rules for updating the display of WebVTT text tracks. [WEBVTT]

`表示~状態@tC ◎ The display state

これは、 ~cueたちを一貫した位置に保つために，具現化~modelを成す一部として利用される。 ◎ This is used as part of the rendering model, to keep cues in a consistent position.＼

初期~時は空になるモノトスル。 ◎ It must initially be empty.＼

~cueの`作動中か$tCが ~F になったときは、 `表示~状態$tCを空にするモノトスル。 ◎ Whenever the text track cue active flag is unset, the user agent must empty the text track cue display state.

`~media要素$の`~tT~list$を成す各`~tT$の`~cue~list$tTを成す`~cue$たちの順序は、 次に従って決定される `~cue順序@ に従うモノトスル： ◎ The text track cues of a media element's text tracks are ordered relative to each other in the text track cue order, which is determined as follows:＼

1. 異なる`~tT$の`~cue~list$tT内にある`~cue$どうしは、 `~tT~list$における`~tT$の順序に従う。 ◎ first group the cues by their text track, with the groups being sorted in the same order as their text tracks appear in the media element's list of text tracks;＼

2. 同じ`~tT$の`~cue~list$tTを成す`~cue$たちの順序は、 次に従うモノトスル： ◎ ↓

   1. `開始~時刻$tCが早いもの順に~sortする ◎ then, within each group, cues must be sorted by their start time, earliest first;＼
   2. `開始~時刻$tCが一致するものどうしは、 `終了~時刻$tCが遅いもの順に~sortする ◎ then, any cues with the same start time must be sorted by their end time, latest first;＼
   3. `終了~時刻$tCも一致するものどうしは、 `~cue~list$tTに追加された順序で~sortする （なので、 例えば，~WebVTT~fileからの~cueたちは、 初期~時は~cueたちが~file内に~listされた順序になる）。 `WEBVTT$r ◎ and finally, any cues with identical end times must be sorted in the order they were last added to their respective text track list of cues, oldest first (so e.g. for cues from a WebVTT file, that would initially be the order in which the cues were listed in the file). [WEBVTT]

4.8.11.11.2. 帯域内~tTの~source法

`~media資源に特有な~tT@ とは、［ `~media資源$内に見出される~data ］に対応する`~tT$である。 ◎ A media-resource-specific text track is a text track that corresponds to data found in the media resource.

そのような~dataを処理して具現化するための規則は、 関連な仕様に定義される — 例えば，`~media資源$は動画であるなら、 その動画~形式の仕様。 一部の旧来の形式~用の詳細は、 `Sourcing In-band Media Resource Tracks from Media Containers into HTML^cite `INBAND$r 【！~media容器から~HTMLの中への帯域内~media資源~trackの~source法】 に見出せる。 ◎ Rules for processing and rendering such data are defined by the relevant specifications, e.g. the specification of the video format if the media resource is a video. Details for some legacy formats can be found in Sourcing In-band Media Resource Tracks from Media Containers into HTML. [INBAND]

4.8.11.11.3. 帯域外~tTの~source法

`track$e 要素を作成したときは、 以下に従って設定される新たな`~tT$ — 以下では、 “要素に対応する~tT” と称される — （および，その~tTを表現している新たな `TextTrack$I ~obj） を結付けるモノトスル。 この~tTの： ◎ When a track element is created, it must be associated with a new text track (with its value set as defined below) and its corresponding new TextTrack object.

• `種類$tTは、 次の表tの 1 列目に与える要素の `kind$aT 属性の状態に応じて，同じ行の 2 列目に与えられる文字列になるとする： ◎ The text track kind is determined from the state of the element's kind attribute according to the following table; for a state given in a cell of the first column, the kind is the string given in the second column:

  状態	文字列
  `Subtitles$st	`subtitles$l
  `Captions$st	`captions$l
  `Descriptions$st	`descriptions$l
  `Chapters$st	`chapters$l
  `Metadata$st	`metadata$l

• `~label$tTは、 要素の`~track~label$になるとする。 ◎ The text track label is the element's track label.
• `言語$tTは、 要素の`~track言語$が［ 非 ε ならばそれ／ ε ならば空~文字列 ］になるとする。 ◎ The text track language is the element's track language, if any, or the empty string otherwise.

`track$e 要素の［ `kind$aT ／ `label$aT ／ `srclang$aT ］属性が［ 設定-／変更-／除去- ］された（順不同）ときは、 `~tT$の［ `種類$tT／`~label$tT／`言語$tT ］も，上の定義に則って更新するモノトスル。 ◎ As the kind, label, and srclang attributes are set, changed, or removed, the text track must update accordingly, as per the definitions above.

`~track~URL$に対する変更は、 下に与える~algoにて取扱われる。 ◎ Changes to the track URL are handled in the algorithm below.

この`~tT$の： ◎ ↓

• `準備度$tTは、 初期~時は `未読込み$i になるとする。 ◎ The text track readiness state is initially not loaded,＼
• `~mode$tTは、 初期~時は `~disabled$i になるとする。 ◎ and the text track mode is initially disabled.
• `~cue~list$tTは、 初期~時は空とする。 これは、 参照先の~fileが構文解析されるとき，動的に改変される。 ◎ The text track list of cues is initially empty. It is dynamically modified when the referenced file is parsed.＼
• `具現化を更新するための規則$は、 初期~時は ε （未設定）とする。 これは、 【`~cue~list$tTに最初に`~cue$が追加されるとき，その~fileの】 形式~用に適切なそれになる — ~WebVTT用には、 これは`~WebVTT~tTの表示を更新するための規則$になる。 `WEBVTT$r ◎ Associated with the list are the rules for updating the text track rendering appropriate for the format in question; for WebVTT, this is the rules for updating the display of WebVTT text tracks. [WEBVTT]

4.8.11.11.4. 様々な形式における~cueを`~cue$として公開するための指針

~HTML~UAにより処理する目的において，特定の形式の~cueたちをどう解釈するかは、 その形式により定義される。 そのような仕様が無い下では、 この節が，いくつかの拘束を供する — 実装は、 そのような形式を，それらの拘束に整合する下で公開するよう試みれる。 ◎ How a specific format's text track cues are to be interpreted for the purposes of processing by an HTML user agent is defined by that format. In the absence of such a specification, this section provides some constraints within which implementations can attempt to consistently expose such formats.

~HTMLの`~tT$~modelを~supportするため、 時間同期的な~dataは，各~data単位ごとに`~cue$に変換される。 当の形式の特能から［ この仕様にて定義される`~cue$を成す ある側面 ］への対応付けが定義されない所では、 実装は，対応付けが［ 上で定義した`~cue$を成す当の側面の定義にも，次に挙げる拘束にも整合する ］ことを確保するモノトスル： ◎ To support the text track model of HTML, each unit of timed data is converted to a text track cue. Where the mapping of the format's features to the aspects of a text track cue as defined in this specification are not defined, implementations must ensure that the mapping is consistent with the definitions of the aspects of a text track cue as defined above, as well as with the following constraints:

`識別子$tC ◎ The text track cue identifier

当の形式には，~~個々の~cue識別子を成す明らかな相似物が無い場合、 空~文字列に設定されるベキである。 ◎ Should be set to the empty string if the format has no obvious analogue to a per-cue identifier.

`退出-時に静止するか$tC ◎ The text track cue pause-on-exit flag

~F に設定されるベキである。 ◎ Should be set to false.

4.8.11.11.5. ~tT~API

[Exposed=Window]
interface `TextTrackList@I : `EventTarget$I {
  readonly attribute unsigned long `length$ttL;
  `getter$ttL `TextTrack$I (unsigned long %index);
  `TextTrack$I? `getTrackById$ttL(DOMString %id);

  attribute `EventHandler$I `onchange$m;
  attribute `EventHandler$I `onaddtrack$m;
  attribute `EventHandler$I `onremovetrack$m;
};

enum `TextTrackMode@I { `disabled$l, `hidden$l, `showing$l };
enum `TextTrackKind@I { `subtitles$l, `captions$l, `descriptions$l, `chapters$l, `metadata$l };

[Exposed=Window]
interface `TextTrack@I : `EventTarget$I {
  readonly attribute `TextTrackKind$I `kind$tt;
  readonly attribute DOMString `label$tt;
  readonly attribute DOMString `language$tt;

  readonly attribute DOMString `id$tt;
  readonly attribute DOMString `inBandMetadataTrackDispatchType$tt;

  attribute `TextTrackMode$I `mode$tt;

  readonly attribute `TextTrackCueList$I? `cues$tt;
  readonly attribute `TextTrackCueList$I? `activeCues$tt;

  undefined `addCue$tt(`TextTrackCue$I %cue);
  undefined `removeCue$tt(`TextTrackCue$I %cue);

  attribute `EventHandler$I `oncuechange$m;
};

var %sfx = new Audio('sfx.wav');
var %sounds = %sfx.addTextTrack('metadata');

/* 
~~目的の音響を追加する
◎
add sounds we care about
 */
function addFX(%start, %end, %name) {
  var %cue = new VTTCue(%start, %end, '');
  %cue.id = %name;
  %cue.pauseOnExit = true;
  %sounds.addCue(%cue);
}
addFX(12.783, 13.612, 'ワン');
addFX(13.612, 15.091, 'ニャン');

function playSound(%id) {
  %sfx.currentTime = %sounds.getCueById(id).startTime;
  %sfx.play();
}

/* 
できるだけ~~早く “ワン” を再生する
◎
play a bark as soon as we can
 */
%sfx.oncanplaythrough = function () {
  playSound('ワン');
}
/* 
利用者が~pageから去ろうとしたとき、
“ニャン” を再生して，~~留まるようお願いする。
◎
meow when the user tries to leave, and have the browser ask them to stay
 */
window.onbeforeunload = function (%e) {
  playSound('ニャン');
  %e.preventDefault();
}

[Exposed=Window]
interface `TextTrackCueList@I {
  readonly attribute unsigned long `length$ttCL;
  `getter$ttCL `TextTrackCue$I (unsigned long %index);
  `TextTrackCue$I? `getCueById$ttCL(DOMString %id);
};

[Exposed=Window]
interface `TextTrackCue@I : `EventTarget$I {
  readonly attribute `TextTrack$I? `track$ttC;

  attribute DOMString `id$ttC;
  attribute double `startTime$ttC;
  attribute unrestricted double `endTime$ttC;
  attribute boolean `pauseOnExit$ttC;

  attribute `EventHandler$I `onenter$m;
  attribute `EventHandler$I `onexit$m;
};

4.8.11.11.6. ~tT~APIを成す~obj用の~event~handler

`TextTrackList$I ~interfaceを実装する~objは、 次に挙げる`~event~handler$（および対応する`~event~handler~event型$）を`~event~handler~IDL属性$として~supportするモノトスル： ◎ The following are the event handlers that (and their corresponding event handler event types) that must be supported, as event handler IDL attributes, by all objects implementing the TextTrackList interface:

`TextTrack$I ~interfaceを実装する~objは、 次に挙げる`~event~handler$（および対応する`~event~handler~event型$）を`~event~handler~IDL属性$として~supportするモノトスル： ◎ The following are the event handlers that (and their corresponding event handler event types) that must be supported, as event handler IDL attributes, by all objects implementing the TextTrack interface:

`TextTrackCue$I ~interfaceを実装する~objは、 次に挙げる`~event~handler$（および対応する`~event~handler~event型$）を`~event~handler~IDL属性$として~supportするモノトスル： ◎ The following are the event handlers (and their corresponding event handler event types) that must be supported, as event handler IDL attributes, by all objects implementing the TextTrackCue interface:

4.8.11.11.7. ~metadata~tT用の最善な実施

~tTは、 ~media~dataに関係している~dataを［ 対話的な／増補された ］~view用に格納するために利用できる。 ◎ Text tracks can be used for storing data relating to the media data, for interactive or augmented views.

例えば，~sports放送を示している~pageは、 現在の~scoreについての情報を含むこともできる。 あるロボコンが~live0で~streamされているとする。 画像には、 次のように~scoreを積層することもできる： ◎ For example, a page showing a sports broadcast could include information about the current score. Suppose a robotics competition was being streamed live. The image could be overlaid with the scores, as follows:

利用者が動画~内の任意な地点へ~seekするたびに，~score表示が正しく具現化されるようにするためには、 ~score用の各~metadata~cueを，適切な長さにする必要がある。 例えば，上の~frameには、［ 対戦~番号を与え，対戦の長さまで居残る~cue ］, ［ 青チームの~scoreが変化するまで居残る~cue ］, ［ 赤チームの~scoreが変化するまで居残る~cue ］が 1 個ずつあることになろう。 動画が~live0~eventの~streamである場合、 右下における時刻は、 ある~cueに基づくのではなく，現在の動画~時刻から自動的に導出されるものと~~想定されることになる。 しかしながら，動画が~highlightであった場合、 それを成す各~cueにて与えられ得る。 ◎ In order to make the score display render correctly whenever the user seeks to an arbitrary point in the video, the metadata text track cues need to be as long as is appropriate for the score. For example, in the frame above, there would be maybe one cue that lasts the length of the match that gives the match number, one cue that lasts until the blue alliance's score changes, and one cue that lasts until the red alliance's score changes. If the video is just a stream of the live event, the time in the bottom right would presumably be automatically derived from the current video time, rather than based on a cue. However, if the video was just the highlights, then that might be given in cues also.

~WebVTT~file内で これを成す素片が，どの様な見かけになるかを次に示す： ◎ The following shows what fragments of this could look like in a WebVTT file:

WEBVTT

...

05:10:00.000 --> 05:12:15.000
matchtype:予選
matchnumber:37

...

05:11:02.251 --> 05:11:17.198
赤:78

05:11:03.672 --> 05:11:54.198
青:66

05:11:17.198 --> 05:11:25.912
赤:80

05:11:25.912 --> 05:11:26.522
赤:83

05:11:26.522 --> 05:11:26.982
赤:86

05:11:26.982 --> 05:11:27.499
赤:89

...

ここでの要点は、 ~cueの情報が［ 関連な~eventが適用される時間の長さにわたる ］ように与えられることに注意。 代わりに，~scoreの変化~時に、 長さ 0 （あるいは， 0 に近い長さ）の~cueとして~scoreが与えられた場合 — 例えば 05:11:17.198 の所で “赤に 2 点を加算する”, 05:11:25.912 の所で “赤に 3 点を加算する”, 等々のように — 問題が発生する： ~~第一に，~seekingを実装するのは、 ずっと難しくなる — ~scriptは、 どの通知も見逃さないよう，~cueたちが成す~list全体を調べ尽くす必要があるので。 加えて，~cueが短い場合、 それが作動中にあることは — 特定的に~listenしない限り — ~scriptからは，決して見えない可能性もある。 ◎ The key here is to notice that the information is given in cues that span the length of time to which the relevant event applies. If, instead, the scores were given as zero-length (or very brief, nearly zero-length) cues when the score changes, for example saying "red+2" at 05:11:17.198, "red+3" at 05:11:25.912, etc, problems arise: primarily, seeking is much harder to implement, as the script has to walk the entire list of cues to make sure that no notifications have been missed; but also, if the cues are short it's possible the script will never see that they are active unless it listens to them specifically.

作者には，この方式で~cueたちを利用するときは、 `cuechange$et ~eventを利用して，現在の注釈を更新することが奨励される。 （特に， `timeupdate$et ~eventを利用するのは適切とは言えない。 なぜなら、 ~cueが変化しないときでも作業を要することに加え，もっと重要なこととして — `timeupdate$et ~eventは~rateが制限されるので — 当の~metadata~cueが作動中になってから表示が更新されるまでの待時間が長くなるので。） ◎ When using cues in this manner, authors are encouraged to use the cuechange event to update the current annotations. (In particular, using the timeupdate event would be less appropriate as it would require doing work even when the cues haven't changed, and, more importantly, would introduce a higher latency between when the metadata cues become active and when the display is updated, since timeupdate events are rate-limited.)