DOM

：

インターフェイス

：

VideoTrackList インターフェイス

　 編集：2022.04.01 by T.A.

→●、MS

このインターフェイスは、<video> 要素内に含まれる動画トラックのリストを表すために使用します。各トラックはリスト内の個別の VideoTrack オブジェクトで表します。

HTMLMediaElement.videoTracks を使用してこのオブジェクトのインスタンスを取得します。個々のトラックは、配列構文または forEach() などの関数を使用してアクセスできます。

プロパティ

このインターフェイスは、その親インターフェイスである EventTarget からもプロパティを継承します。

VideoTrackList.length 読取専用 ●
リスト内のトラック数。
VideoTrackList.selectedIndex 読取専用 ●
現在選択されているトラックがある場合はそのインデックス、それ以外の場合は -1。
メソッド

このインターフェイスは、その親インターフェイスである EventTarget からもメソッドを継承しています。

VideoTrackList.getTrackById() ●
指定された文字列と id が一致する VideoTrackList 内で見つかった VideoTrack を返します。一致が見つからない場合は、null を返します。
イベントハンドラー
VideoTrackList.onaddtrack
addtrack イベントが発生したときに呼び出されるイベントハンドラー。新しい動画トラックがメディア要素に追加されたことを示します。
VideoTrackList.onchange
change (en-US) イベントが発生したときに呼び出されるイベントハンドラー。つまりトラックの selected プロパティの値が変更されて、トラックがアクティブまたは非アクティブになったときです。
VideoTrackList.onremovetrack
removetrack イベントが発生したときに呼び出されるイベントハンドラー。動画トラックがメディア要素から取り除かれたことを示します。
イベント
addtrack
新しい動画トラックがメディア要素に追加されたときに発生します。

onaddtrack プロパティからも利用できます。

change
動画トラックがアクティブまたは非アクティブになったときに発生します。

onchange プロパティからも利用できます。

removetrack
動画トラックがメディア要素から取り除かれたときに発生します。

onremovetrack プロパティからも利用できます。

トラック分類：
分類 定義 適用対象
例
"alternative" 主トラック用に可能な代替 ― 例えば 歌の異なる take（音声）／異なる angle（動画） 音声／動画
  • Ogg： "audio/alternate"／"video/alternate"
  • DASH： "alternate" role を有していて、［"main"、"commentary" role （動画）／"dub" role（音声）］は有さないもの（他の role は無視される）。
"captions" 主動画トラックにキャプションが焼き付けられたバージョン。（旧来の内容用 ― 新たな内容はテキスト･トラックを利用することになる。） 動画のみ
  • DASH：［"caption"、"main"］両 role を有するもの（他の role は無視される）。
"descriptions" 動画トラックの音述。 音声のみ
  • Ogg： "audio/audiodesc" 。
"main" 主たる［音声／動画］トラック。 音声／動画
  • Ogg： "audio/main"／"video/main"
  • WebM： "FlagDefault" 要素が設定されているもの
  • DASH： "main" role を有していて［"caption"、"subtitle"、"dub"］role は有さないもの（他の role は無視される）。
"main-desc" 音述が混合された主たる音声トラック。 音声のみ
  • MPEG-2 内の AC3 音声： TS: bsmod=2、full_svc=1
"sign" 音声トラックの手話解釈。 動画のみ
  • Ogg： "video/sign"
"subtitles" 主動画トラックに字幕が焼き付けられたバージョン。（旧来の内容用 ― 新たな内容はテキスト･トラックを利用することになる。） 動画のみ
  • DASH：［"subtitle"、"main"］両 role を有するもの（他の role は無視される）。
"translation" 主音声トラックの翻訳されたバージョン。 音声のみ
  • Ogg： "audio/dub"
  • DASH： ［"dub"、"main"］両 role を有するもの（他の role は無視される）。
"commentary" 主たる［音声／動画］トラックの実況 ― 例：director による実況。 音声／動画
  • DASH： "commentary" role を有していて、"main" role は有さないもの（他の role は無視される）。
空文字列 明示的な種類はない、または これ°のメタデータが与える種類はユーザー･エージェントにより認識されていない。 音声／動画
―
テスト
HTML：

ここに表示
スクリプト組み込み：



スクリプト：


スクリプト：



表示内容：
表示内容：