HTMLMediaElement:audioTracks 属性

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

HTMLMediaElement 对象的只读属性 audioTracks 返回一个 AudioTrackList 对象,该对象列出了所有表示媒体元素音频轨道的 AudioTrack 对象。

媒体元素可能是一个 <audio> 元素或 <video> 元素。

所返回的列表是动态的;即,当音频轨道从媒体元素上增加或删除时,列表的内容将会动态的变化。一旦你引用了该列表,你可以监控它以检测何时添加了新的音轨或删除了已存在的音轨。参阅 AudioTrackList 事件以了解更多有关获取媒体元素音轨列表变化的信息。

返回值

一个 AudioTrackList 对象,表示一个媒体元素中所包含的音频轨道的列表。音轨列表可以使用数组表示法或对象的 getTrackById() 方法访问。

每个音轨都是由一个提供音轨信息的 AudioTrack 对象表示的。

示例

在这个示例中,给定元素的所有的音频轨道都是被静音的。

HTML

构建元素本身的 HTML。

html
<video id="video" src="somevideo.mp4"></video>

JavaScript

这段 JavaScript 代码负责将视频元素的音轨静音。

js
const video = document.getElementById("video");

for (let i = 0; i < video.audioTracks.length; i += 1) {
  video.audioTracks[i].enabled = false;
}

规范

Specification
HTML
# dom-media-audiotracks-dev

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
audioTracks

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
User must explicitly enable this feature.
Has more compatibility info.

参见