大网数据广告活动
Web 标准与前端开发

HTMLMediaElement:audioTracks 属性

· 52CE 我爱测

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

HTML DOM

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

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

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

返回值

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

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

示例

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

HTML

构建元素本身的 HTML。

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

JavaScript

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

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

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

规范

浏览器兼容性

参见

  • HTMLMediaElement:用于定义 HTMLMediaElement.audioTracks 属性的接口
  • audio、video
  • AudioTrack、AudioTrackList

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。