VideoTrack | Web API

在此页

特性
用法注意事项
规范
浏览器兼容性
相关话题

VideoTrack interface represents a single video track from a <video> 元素。 The most common use for accessing a VideoTrack object is to toggle its selected property in order to make it the active video track for its <video> 元素。

特性

selected: A Boolean value which controls whether or not the video track is active. Only a single video track can be active at any given time, so setting this property to true for one track while another track is active will make that other track inactive.
id 只读: DOMString which uniquely identifies the track within the media. This ID can be used to locate a specific track within a video track list by calling VideoTrackList.getTrackById() . The ID can also be used as the fragment part of the URL if the media supports seeking by media fragment per the Media Fragments URI specification .
kind 只读: DOMString specifying the category into which the track falls. For example, the main video track would have a kind of "main" .
label 只读: DOMString providing a human-readable label for the track. For example, a track whose kind is "sign" might have a label of "A sign-language interpretation" . This string is empty if no label is provided.
语言 只读: DOMString specifying the video track's primary language, or an empty string if unknown. The language is specified as a BCP 47 ( RFC 5646 ) language code, such as "en-US" or "pt-BR" .
sourceBuffer 只读: SourceBuffer that created the track. Returns null if the track was not created by a SourceBuffer 或 SourceBuffer has been removed from the MediaSource.sourceBuffers attribute of its parent media source.

用法注意事项

To get a VideoTrack for a given media element, use the element's videoTracks property, which returns a VideoTrackList object from which you can get the individual tracks contained in the media:

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

You can then access the media's individual tracks using either array syntax or functions such as forEach() .

This first example gets the first video track on the media:

var firstTrack = tracks[0];

The next example scans through all of the media's video tracks, activating the first video track that is in the user's preferred language (taken from a variable userLanguage ).

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

语言 is in standard ( RFC 5646 ) format. For US English, this would be "en-US" ，例如。

规范

规范	状态	注释
HTML 实时标准 The definition of 'VideoTrack' in that specification.	实时标准

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`VideoTrack`	Chrome 45 Disabled 45 Disabled Disabled From version 45: 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 Disabled 79 Disabled Disabled From version 79: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 不支持 12 — 79	Firefox 33	IE 10	Opera 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari 6.1	WebView Android 45	Chrome Android 45 Disabled 45 Disabled Disabled From version 45: 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	Opera Android 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari iOS 7	Samsung Internet Android No
`id`	Chrome 45 Disabled 45 Disabled Disabled From version 45: 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 Disabled 79 Disabled Disabled From version 79: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 不支持 12 — 79	Firefox 33	IE 10	Opera 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari 6.1	WebView Android 45	Chrome Android 45 Disabled 45 Disabled Disabled From version 45: 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	Opera Android 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari iOS 7	Samsung Internet Android No
`kind`	Chrome 45 Disabled 45 Disabled Disabled From version 45: 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 Disabled 79 Disabled Disabled From version 79: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 不支持 12 — 79	Firefox 33	IE 10	Opera 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari 6.1	WebView Android 45	Chrome Android 45 Disabled 45 Disabled Disabled From version 45: 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	Opera Android 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari iOS 7	Samsung Internet Android No
`label`	Chrome 45 Disabled 45 Disabled Disabled From version 45: 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 Disabled 79 Disabled Disabled From version 79: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 不支持 12 — 79	Firefox 33	IE 10	Opera 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari 6.1	WebView Android 45	Chrome Android 45 Disabled 45 Disabled Disabled From version 45: 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	Opera Android 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari iOS 7	Samsung Internet Android No
`语言`	Chrome 45 Disabled 45 Disabled Disabled From version 45: 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 Disabled 79 Disabled Disabled From version 79: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 不支持 12 — 79	Firefox 33	IE 10	Opera 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari 6.1	WebView Android 45	Chrome Android 45 Disabled 45 Disabled Disabled From version 45: 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	Opera Android 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari iOS 7	Samsung Internet Android No
`selected`	Chrome 45 Disabled 45 Disabled Disabled From version 45: 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 Disabled 79 Disabled Disabled From version 79: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 不支持 12 — 79	Firefox 33	IE 10	Opera 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari 6.1	WebView Android 45	Chrome Android 45 Disabled 45 Disabled Disabled From version 45: 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	Opera Android 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari iOS 7	Samsung Internet Android No
`sourceBuffer`	Chrome 45 Disabled 45 Disabled Disabled From version 45: 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 Disabled 79 Disabled Disabled From version 79: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ). 不支持 12 — 79	Firefox No	IE 10	Opera 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari 6.1	WebView Android 45	Chrome Android 45 Disabled 45 Disabled Disabled From version 45: 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 No	Opera Android 32 Disabled 32 Disabled Disabled From version 32: this feature is behind the `enable-experimental-web-platform-features` preference (needs to be set to `enabled` ).	Safari iOS 7	Samsung Internet Android No

图例

完整支持
不支持
用户必须明确启用此特征。

元数据

最后修改： May 27, 2019

在此页

特性

用法注意事项

规范

浏览器兼容性

图例

相关话题