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

媒体捕捉与媒体流 API(媒体流)

· 52CE 我爱测

媒体捕捉与媒体流 API**(Media Capture and Streams API),通常被称为**媒体流 API**(Media Streams API、MediaStream API),是与 WebRTC 相关的 API,提供对音频或视频数据流的支持。

Media Capture and Streams

媒体捕捉与媒体流 API(Media Capture and Streams API),通常被称为媒体流 API(Media Streams API、MediaStream API),是与 WebRTC 相关的 API,提供对音频或视频数据流的支持。

它提供了用于处理媒体流及其组成轨道的接口和方法、与数据格式相关的约束、异步使用数据时成功和错误的回调以及在处理期间触发的事件。

概念和用法

这个 API 基于对表示音视频相关数据流的 MediaStream 对象的所有操作。参见获取媒体流中的示例。

一个 MediaStream 包含零个或多个代表各种声音和视频轨道的 MediaStreamTrack 对象。每一个 MediaStreamTrack 可能有一个或多个通道。这个通道代表着媒体流的最小单元,比如一个音频信号对应着一个对应的扬声器,像是在立体声道中的左声道或右声道。

MediaStream 对象有着单一的输入和输出。由 MediaDevices.getUserMedia 创建的 MediaStream 对象是在本地借助用户相机和麦克风的源输入。非本地的 MediaStream 可能代表一个媒体元素(如 video 或 audio),或是一个通过 WebRTC RTCPeerConnection API 获得的源自网络的媒体流,又或是一个使用 Web 音频 API 的 MediaStreamAudioDestinationNode 创建的媒体流。

MediaStream 对象的输出能连接到一个消费端(consumer)。它可以是一个媒体元素(如 <audio> 或 <video>),也可以是 WebRTC RTCPeerConnection API 或 Web 音频 API 的 MediaStreamAudioSourceNode。

接口

在这些参考文章中,你将找到需要了解的构成媒体捕捉和媒体流 API 的每个接口的基本信息。

  • CanvasCaptureMediaStreamTrack
  • InputDeviceInfo
  • MediaDeviceInfo
  • MediaDevices
  • MediaStream
  • MediaStreamEvent
  • MediaStreamTrack
  • MediaStreamTrackEvent
  • MediaTrackConstraints
  • MediaTrackSettings
  • MediaTrackSupportedConstraints
  • OverconstrainedError
  • URL

事件

  • MediaStream/addtrack_event
  • MediaStreamTrack/ended_event
  • MediaStreamTrack/mute_event
  • MediaStreamTrack.overconstrained_event
  • MediaStream/removetrack_event
  • MediaStreamTrack/unmute_event

指南和教程

功能、约束和设置文章讨论了约束、功能以及媒体设置的概念,并包含了一个约束练习器,它允许你尝试应用于来自计算机音视频输入设备(如网络摄像头和麦克风)的音频和视频轨道的不同约束集的结果。

使用 getUserMedia() 拍摄静态照片文章展示了如何使用 getUserMedia() 来访问支持 getUserMedia() 的计算机或移动设备上的摄像头,并使用它拍摄照片。

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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