1. 面向开发者的 Web 技术
  2. Web API
  3. HTMLMediaElement
  4. HTMLMediaElement：audioTracks 属性

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

HTMLMediaElement：audioTracks 属性

有限可用

此特性不属于基线，因为它尚未在主流浏览器中得到支持。

Want more browser support for this feature? Tell us why.

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;
}

规范

规范
HTML
# dom-media-audiotracks-dev

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题