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

MediaStream.getAudioTracks()

· 52CE 我爱测

MediaStream 接口下的 **_`getAudioTracks()`_** 方法会返回一个包含 `track set` 流中所有 MediaStreamTrack.kind 为 `audio` 的 MediaStreamTrack 对象序列。

Media Capture and Streams

MediaStream 接口下的 getAudioTracks() 方法会返回一个包含 track set 流中所有 MediaStreamTrack.kind 为 audio 的 MediaStreamTrack 对象序列。

语法

getAudioTracks()

参数

无

返回值

MediaStreamTrack 对象数组,包含流中所有的音轨。音轨的 MediaStreamTrack.kind 值为 audio 。如果流中不包含音轨,则数组为空。

[!NOTE] 数组中返回的顺序并不是由规范定义的,事实上,每次调用 getAudioTracks() 的结果都可能有所不同。

更早版本的本 API 中,包含一个用做列表中每个音频类型的 AudioStreamTrack 接口;现在已被合并至 MediaStreamTrack 主接口中。

示例

本示例使用 MediaDevices.getUserMedia 获取视频流中的网络摄像机的音频和视频,并将媒体流绑定到 video 元素,然后设置一个计时器,计时器到期时会停止在该媒体流中找到的第一个音轨。

navigator.mediaDevices
  .getUserMedia({ audio: true, video: true })
  .then((mediaStream) => {
    document.querySelector("video").srcObject = mediaStream;
    // Stop the audio stream after 5 seconds
    setTimeout(() => {
      const tracks = mediaStream.getAudioTracks();
      tracks[0].stop();
    }, 5000);
  });

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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