HTMLMediaElement: audioTracks 属性

有限可用性

此功能不是基线,因为它在一些最常用的浏览器中不起作用。

只读 **audioTracks** 属性在 HTMLMediaElement 对象上返回一个 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;
}

规范

规范
HTML 标准
# dom-media-audiotracks-dev

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅