HTMLCanvasElement.captureStream() メソッドは、canvas の前面をリアルタイムにキャプチャした動画を CanvasCaptureMediaStream として返すメソッドです。
構文
MediaStream = canvas.captureStream(frameRate);
引数
frameRateOptional- キャプチャする際のフレームレートを倍精度浮動小数点数で指定します。指定しなかった場合、canvas が変化するたびにフレームが新しくキャプチャされます。0 を指定した場合、フレームが 1 枚だけキャプチャされます。
戻り値
MediaStream オブジェクトへの参照を返します。
使用例
// キャプチャしたい canvas 要素を取得
var canvasElt = document.querySelector('canvas');
// ストリームの取得
var stream = canvasElt.captureStream(25); // 25 FPS
// 取得したストリームに対して何らかの処理を行う
// 例：RTCPeerConnection を使って別のコンピュータに送信
// ここで pc は既に生成された RTCPeerConnection オブジェクト
pc.addStream(stream);
仕様
| 仕様書 | 策定状況 | 備考 |
|---|---|---|
| Media Capture from DOM Elements HTMLCanvasElement.captureStream() の定義 |
草案 | 初期定義 |
ブラウザ実装状況
現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。
この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。
手助けしていただける場合は、こちらから！
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | 51.0 | 43 (43)[1] | 未サポート | 36.0 | ? |
| 機能 | Android | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| 基本サポート | 未サポート | 51.0 | 51.0 | 43.0 (43) | 未サポート | 38 | ? |
[1] Firefox 41 / 42 では機能がデフォルトで無効となっています。 有効にする場合は canvas.capturestream.enabled の設定項目を true に変更してください。
関連情報
CanvasCaptureMediaStream- 戻り値のインターフェイスHTMLMediaElement.captureStream()- media 要素からストリームをキャプチャするメソッドMediaStreamMedia Capture and Streams API