DOM

：

インターフェイス

：

AudioTrackList インターフェイス

　 編集：2022.04.01 by T.A.

→●、MS

このインターフェイスは、所与の HTML メディア要素内に含まれる音声トラックのリストを表すために使用します。各トラックはリスト内の別々の AudioTrack オブジェクトで表します。

HTMLMediaElement.audioTracks を使用してこのオブジェクトのインスタンスを取得します。個々のトラックは、配列構文を使用してアクセスできます。

プロパティ

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

AudioTrackList.length 読取専用 ●
リスト内のトラック数。
メソッド

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

AudioTrackList.getTrackById() ●
指定された文字列と一致する id を持つ AudioTrackList 内で見つかった AudioTrack を返します。一致が見つからない場合は、null を返します。
イベントハンドラー
AudioTrackList.onaddtrack
addtrack イベントが発生したときに呼び出されるイベントハンドラー。新しい音声トラックがメディア要素に追加されたことを示します。
AudioTrackList.onchange
change (en-US) イベントが発生したときに呼び出されるイベントハンドラー。これは、1つ以上のトラックが enabled フラグの変更により有効または無効になったときに発生します。
AudioTrackList.onremovetrack
removetrack イベントが発生したときに呼び出されるイベントハンドラー。音声トラックがメディア要素から取り除かれたことを示します。
イベント
addtrack
新しい音声トラックがメディア要素に追加されたときに発生します。

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

change
トラックが有効または無効にされたときに発生します。

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

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

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

使用上の注意

AudioTrackList を使用すると、メディア要素にある音声トラックに直接アクセスできるだけでなく、addtrack イベントと removetrack イベントにイベントハンドラーを設定できるため、メディア要素のストリームにトラックが追加されたときまたは取り除かれたときに検出できます。詳細と例については、onaddtrack と onremovetrack を参照してください。

例
メディア要素の音声トラックリストの取得
メディア要素の AudioTrackList を取得するには、その audioTracks プロパティを使用します。 
var audioTracks = document.querySelector("video").audioTracks;
トラック数の変化の監視
この例では、利用可能なチャンネル数に関する情報を表示するアプリがあります。それを最新に保つために、addtrack イベントと removetrack イベントのためのハンドラーを設定しています。 
audioTracks.onaddtrack = updateTrackCount;
audioTracks.onremovetrack = updateTrackCount;

function updateTrackCount(event) {
  trackCount = audioTracks.length;
  drawTrackCountIndicator(trackCount);
}
audioTrack=media.audioTracks[index] ●
指定された AudioTrack オブジェクトを返す。
トラック分類：
分類 定義 適用対象
例
"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：

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



スクリプト：


スクリプト：



表示内容：
表示内容：