从 DOM 元素进行媒体捕获

captureStream() 方法会生成对 渲染到媒体元素的媒体的实时捕获。

捕获的 MediaStream 由若干 MediaStreamTrack 组成，这些轨道会渲染来自媒体元素中一组 选定（对于 VideoTrack， 或其他互斥选定的 track 类型）或 启用 （对于 AudioTrack， 或其他支持 多重选择的 track 类型）的 track 的内容。如果媒体元素 没有给定类型的选定或启用 track，则捕获流中不会存在该类型的 MediaStreamTrack。

因此， video 元素可以捕获一个视频 MediaStreamTrack 和任意数量的音频 MediaStreamTrack。 而 audio 元素可以捕获 任意数量的音频 MediaStreamTrack。 在这两种情况下， 捕获的 MediaStreamTrack 集合都可以为空。

除非并直到存在给定类型且已选定或启用的 track， 否则捕获流中不存在该类型的 MediaStreamTrack。 尤其是，如果媒体元素没有分配源，则捕获的 MediaStream 没有任何轨道。因此，ready state 为 HAVE_NOTHING 的媒体元素不会生成任何捕获的 MediaStreamTrack 实例。一旦元数据 可用且选定或启用的 track 得以确定，就会创建新的捕获 MediaStreamTrack 实例并将其添加到 MediaStream。

当MediaStreamTrack 捕获的 结束于播放 结束（且 ended 事件触发）时，或当它捕获的轨道不再被选定或启用于播放时， 捕获的轨道会结束。如果通过设置媒体元素的 src 或 srcObject 属性更改了源，则 track 不再被选定或启用。

如果媒体元素的源发生变化，捕获的 MediaStreamTrack 集合也会发生变化。如果媒体元素的源结束，则会选择不同的源。

如果媒体元素的选定 VideoTrack 或启用的 AudioTrack 发生变化，则会为每个先前未被选定或启用的 track 生成一个带有新 MediaStreamTrack 的 addtrack 事件；并且会为每个不再被选定或启用的 track 生成一个 removetrack 事件。MediaStreamTrack MUST 在从 MediaStream 移除之前结束。

由于 MediaStreamTrack 只能结束一次，因此一个被启用、 禁用并再次启用的 track 会被捕获为两个独立的 track。类似地， 在播放结束后重新开始播放，会导致创建一组新的捕获 MediaStreamTrack 实例。在播放期间进行查找 而不改变轨道选择，不会生成事件，也不会导致捕获的 MediaStreamTrack 结束。

组成捕获的 MediaStream 的 MediaStreamTrack 会随着它们所捕获的 track 状态变化而变为 muted 或 unmuted。 在任何时候，媒体元素都可能由于多种原因而在给定 track 上没有可供捕获的活动内容：

• 媒体播放可能被暂停。
• 如果当前播放时间 早于该 track 内容的开始时间，或晚于内容的结束时间，则某个 track 可能在当前播放 时间没有内容。
• 作为源的 MediaStreamTrack 可能被 muted 或 disabled。
• 由于跨源保护，track 的内容可能对当前 origin 变得不可访问。例如，从 HTTP URL 渲染的内容可能在对部分内容的请求中受到重定向影响，或者 启用或选定的轨道可能发生变化，从而包含跨源内容。

内容缺失会通过 muted 属性反映在捕获的轨道中。如果其对应的 源 track 没有可用且可访问的内容，则捕获的 MediaStreamTrack 的 muted 属性 MUST 被设置为 true。当内容 可用性发生变化时，会在 MediaStreamTrack 上触发 mute 事件。

muted 捕获所产生的输出会因媒体类型而异： VideoTrack 在 muted 时停止捕获新帧， 导致捕获流显示最后捕获的一帧；muted 的 AudioTrack 会产生静音。

媒体元素是否正在主动渲染内容（例如渲染到屏幕或音频 设备）不会影响捕获流的内容。将媒体元素的音频静音不会导致捕获产生静音， 隐藏媒体元素也不会导致捕获的视频停止。类似地，媒体元素的音频电平或音量 不会影响捕获音频的音量。

来自具有非 1.0 有效 播放速率的元素的捕获音频 MUST 进行时间拉伸。不可播放的播放 速率会导致捕获的音频轨道变为 muted。

captureStream() 方法会生成对 canvas 表面的实时视频 捕获。生成的媒体流具有一个视频 CanvasCaptureMediaStreamTrack， 其尺寸与 canvas 元素的尺寸相匹配。

来自非 origin-clean 的 canvas 的内容 MUST NOT 被捕获。如果 canvas 不是 origin-clean，此方法会抛出 SecurityError 异常。

如果源 canvas 的 origin-clean 标志在流由 captureStream() 创建之后变为 false， 则捕获的流 MUST 立即停止捕获内容。 捕获的 MediaStreamTrack MUST 变为 muted，在 canvas 保持此 状态时不产生任何新内容。

每个捕获 canvas 的 track 都有一个 [[frameCaptureRequested]] 内部槽，当请求从 canvas 获取 新帧时，该内部槽会被设置为 true。

所有新 track 上的 [[frameCaptureRequested]] 的值 在 track 创建时被设置为 true。使用特定且非零的 frameRequestRate 创建捕获轨道时，用户 代理会启动一个周期性定时器，其间隔为 1/frameRequestRate 秒。每次定时器触发时， [[frameCaptureRequested]] 会被设置为 true。

为了通过 requestFrame() 方法支持对帧捕获的手动控制，浏览器 MUST 支持 frameRequestRate 的值为 0。然而，即使 frameRequestRate 为零， 捕获的流 MUST 在创建时请求捕获一个 帧。

如果 frameRequestRate 为负，此方法会抛出 NotSupportedError 异常。

当 [[frameCaptureRequested]] 为 true 且 canvas 被绘制时，会从 canvas 请求一个新帧。 每次捕获的 canvas 被绘制时，都会执行以下步骤：

1. 对于从 canvas 捕获的每个 track，执行以下 步骤：
   1. 如果自上次绘制以来已有新内容绘制到 canvas，并且 如果 track 的 [[frameCaptureRequested]] 内部槽 已被设置，则向 track 添加一个包含绘制到 canvas 上内容的新帧。
   2. 如果指定了 frameRequestRate 值，则将 track 的 [[frameCaptureRequested]] 内部槽 设置为 false。

当向 track 添加包含绘制到 canvas 上内容的新帧时，如果 canvas 不是完全不透明的， 则必须捕获并保留 canvas 的 alpha 通道内容。此 track 的消费者可能不会 保留 alpha 通道。