VideoTrack

VideoTrack インターフェイスは、<video> 要素からの単一の動画トラックを表します。 VideoTrack オブジェクトにアクセスするための最も一般的な用途は、その <video> 要素のアクティブ動画トラックにするために、その selected プロパティを切り替えることです。

プロパティ

selected
動画トラックがアクティブかどうかを制御する Boolean の値。 同時にアクティブにできる動画トラックは1つだけなので、別のトラックがアクティブなときに、あるトラックでこのプロパティを true に設定すると、アクティブであったトラックは非アクティブになります。
id 読取専用
メディア内のトラックを一意に識別する DOMString。この ID を使用して、VideoTrackList.getTrackById() を呼び出して、動画トラックリスト内の特定のトラックを見つけることができます。 メディアが Media Fragments URI 仕様その日本語訳)に従ってメディアフラグメントによるシークをサポートしている場合は、ID を URL のフラグメント部分として使用することもできます。
kind 読取専用
トラックが属するカテゴリを指定する DOMString。 例えば、メイン動画トラックには "main" という kind があります。
label 読取専用
トラックに人間が読めるラベルを提供する DOMString。 例えば、kind"sign" のトラックには "手話通訳" という label が付いている場合があります。 ラベルが指定されていない場合、この文字列は空です。
language 読取専用
動画トラックの主要言語を指定する DOMString、または不明の場合は空の文字列。 言語は、"en-US" または "pt-BR" などの BCP 47(RFC 5646)言語コードとして指定されています。
sourceBuffer 読取専用
トラックを作成した SourceBuffer。トラックが SourceBuffer によって作成されなかった場合、または SourceBuffer がその親メディアソースの MediaSource.sourceBuffers 属性から取り除かれた場合は、null を返します。

使用上の注意

特定のメディア要素の VideoTrack を取得するには、その要素の videoTracks プロパティを使用します。 このプロパティは、メディアに含まれる個々のトラックを取得できる VideoTrackList オブジェクトを返します。

var el = document.querySelector("video");
var tracks = el.videoTracks;

その後、配列の構文または forEach() などの関数を使用して、メディアの個々のトラックにアクセスできます。

この最初の例は、メディア上の最初の動画トラックを取得します。

var firstTrack = tracks[0];

次の例では、メディアのすべての動画トラックをスキャンして、(変数 userLanguage から取得した)ユーザーの優先言語の最初の動画トラックをアクティブにします。

for (var i = 0; i < tracks.length; i++) {
  if (tracks[i].language === userLanguage) {
    tracks[i].selected = true;
    break;
  }
});

language は標準(RFC 5646)形式です。 例えば、アメリカ英語の場合、これは "en-US" になります。

仕様

仕様 状態 コメント
HTML Living Standard
VideoTrack の定義
現行の標準  

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
VideoTrackChrome 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし
idChrome 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし
kindChrome 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし
labelChrome 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし
languageChrome 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし
selectedChrome 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 37
無効
完全対応 37
無効
無効 From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし
sourceBufferChrome 完全対応 51
無効
完全対応 51
無効
無効 From version 51: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 未対応 なしIE 未対応 なしOpera 完全対応 38
無効
完全対応 38
無効
無効 From version 38: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 51
無効
完全対応 51
無効
無効 From version 51: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 未対応 なしOpera Android 完全対応 41
無効
完全対応 41
無効
無効 From version 41: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。