HTMLMediaElement: audioTracks 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

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 (const track of video.audioTracks) {
  track.enabled = false;
}

规范

规范
HTML
# dom-media-audiotracks-dev

浏览器兼容性

另见