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

MediaStreamTrack.stop()

· 52CE 我爱测

调用`stop()`告诉user agent ,MediaStreamTrack不再需要轨道的来源,无论该来源是什么,包括文件,网络流,本地摄像机或麦克风。由于多个音轨可能使用同一音源(例如,如果两个选项卡使用设备的麦克风),则音源本身并不一定会立即停止。而是从轨道取消关联,并且停止跟踪对象。一旦没有媒体轨道正在使用源,则实际上可能会完全停止该源。

Media Capture and Streams

**MediaStreamTrack.stop()**方法停止跟踪。

语法

track.stop()

说明

调用stop()告诉user agent ,MediaStreamTrack不再需要轨道的来源,无论该来源是什么,包括文件,网络流,本地摄像机或麦克风。由于多个音轨可能使用同一音源(例如,如果两个选项卡使用设备的麦克风),则音源本身并不一定会立即停止。而是从轨道取消关联,并且停止跟踪对象。一旦没有媒体轨道正在使用源,则实际上可能会完全停止该源。

调用stop()之后,MediaStreamTrack.readyState属性立即设置为ended。

示例

停止视频流

在此示例中,我们看到一个函数,该函数通过在给定video的每个轨道上调用stop()来停止流式视频。

function stopStreamedVideo(videoElem) {
  const stream = videoElem.srcObject;
  const tracks = stream.getTracks();

  tracks.forEach(function (track) {
    track.stop();
  });

  videoElem.srcObject = null;
}

这是通过从其HTMLMediaElement.srcObject 属性获得视频元素的流来实现的。然后,通过调用其MediaStream.getTracks方法来获取流的轨道列表。从那里开始,剩下要做的就是使用Array.forEach遍历轨道列表并调用每个轨道的stop()方法。

最后,将srcObject设置为null以切断与MediaStream 对象的链接,以便将其释放。

Finally, srcObject is set to null to sever the link to the MediaStream object so it can be released.

规范

浏览器兼容性

看看别的

  • MediaStreamTrack,它所属的接口。
  • MediaStreamTrack.readyState
  • ended

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

资料来源与适用范围

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

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

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