媒体捕捉与媒体流 API（媒体流）

概念和用法

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

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

MediaStream 对象有着单一的输入和输出。由 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

事件

• addtrack
• ended
• mute
• overconstrained
• removetrack
• unmute

指南和教程

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

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

浏览器兼容性

api.MediaStream

api.MediaStreamTrack

api.MediaDevices

api.MediaDeviceInfo

api.InputDeviceInfo

api.CanvasCaptureMediaStreamTrack

参见

• WebRTC——API 介绍页面
• mediaDevices.getUserMedia()
• 使用 WebRTC 拍摄静态照片：有关使用 getUserMedia() 的演示和教程。