リファレンス createCapture()

createCapture()

ウェブカメラとマイクからオーディオ/ビデオストリームを「キャプチャ」する<video></video>要素を作成します。

createCapture()は新しい p5.MediaElementオブジェクトを返します。ビデオは デフォルトで表示されます。capture.hide()を呼び出すことで非表示にでき、 image()を使用してキャンバスに描画できます。

最初のパラメータtypeはオプションです。使用するキャプチャのタイプを設定します。 デフォルトでは、createCapture()は音声とビデオの両方をキャプチャします。 VIDEOが渡された場合(createCapture(VIDEO)のように)、ビデオのみがキャプチャされます。 AUDIOが渡された場合(createCapture(AUDIO)のように)、音声のみがキャプチャされます。 ストリームをカスタマイズするために制約オブジェクトを渡すこともできます。 可能なプロパティについては、W3Cのドキュメントを参照してください。異なるブラウザは異なる プロパティをサポートしています。

'flipped'プロパティはオプションのプロパティで、{flipped:true}に設定すると ビデオ出力を反転させることができます。trueの場合、ビデオが反転または フリップされることを意味し、何も指定されていない場合はデフォルトで falseになります。

2番目のパラメータcallbackはオプションです。これはキャプチャが使用可能になったときに 呼び出す関数です。コールバック関数は1つのパラメータstreamを持つべきで、 これはMediaStreamオブジェクトです。

注意:createCapture()はスケッチをローカルで実行するか、HTTPSを使用する場合にのみ機能します。 詳細はこちらこちらをご覧ください。

実例

シンタックス

createCapture([type], [flipped], [callback])

パラメーター

type
String|Constant|Object:

キャプチャのタイプ。AUDIOまたはVIDEO、 または制約オブジェクト。デフォルトでは ビデオと音声の両方のストリームがキャプチャされます。

flipped
Object:

{flipped:true}でキャプチャしているビデオを反転し、出力をミラーリングします。 デフォルトではfalseです。

callback
Function:

ストリームがロードされた後に 呼び出す関数。

リターン

p5.MediaElement: 新しいp5.MediaElementオブジェクト。
Notice any errors or typos? Please let us know. Please feel free to edit src/dom/dom.js and open a pull request!

関連するリファレンス