---
title: CanvasCaptureMediaStream
slug: Web/API/CanvasCaptureMediaStreamTrack
translation_of: Web/API/CanvasCaptureMediaStreamTrack
original_slug: Web/API/CanvasCaptureMediaStream
---
<div>{{APIRef}}{{SeeCompatTable}}</div>

<p><strong><code>CanvasCaptureMediaStream</code></strong> 接口表示 {{domxref("MediaStream")}} 对 {{domxref("HTMLCanvasElement")}} 元素进行实时画面捕捉的内容。</p>

<h2 id="属性">属性</h2>

<p><em>此接口继承了其父类 {{domxref("MediaStream")}} 与 {{domxref("EventTarget")}} 的属性。</em></p>

<dl>
 <dt>{{domxref("CanvasCaptureMediaStream.canvas")}} {{readonlyInline}}</dt>
 <dd>可返回当前媒体流所对应的 {{domxref("HTMLCanvasElement")}} 元素对象。</dd>
</dl>

<h2 id="方法">方法</h2>

<p><em>此接口继承了其父类 {{domxref("MediaStream")}} 与 {{domxref("EventTarget")}} 的方法。</em></p>

<dl>
 <dt>{{domxref("CanvasCaptureMediaStream.requestFrame()")}}</dt>
 <dd>手动获取媒体流的一帧。 可以捕捉部分渲染帧画面.</dd>
</dl>

<h2 id="说明">说明</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Media Capture DOM Elements', '#idl-def-CanvasCaptureMediaStream', 'CanvasCaptureMediaStream')}}</td>
   <td>{{Spec2('Media Capture DOM Elements')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatChrome(51.0)}}</td>
   <td>{{CompatGeckoDesktop('41')}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatGeckoMobile('41')}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Disabled by default; set the preference <code>canvas.capturestream.enabled</code> to <code>true</code> to activate.</p>

<h2 id="其他参考资料">其他参考资料</h2>

<ul>
 <li>{{domxref("HTMLCanvasElement.captureStream()")}}</li>
</ul>