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 表格仅在浏览器中加载
另请参阅
HTMLMediaElement
: 用于定义HTMLMediaElement.audioTracks
属性的接口<audio>
,<video>
AudioTrack
,AudioTrackList