Media Capture and Streams API (Media Streams)

Media Capture and Streams APIは一般的にMedia Stream APIStream APIと呼ばれるWebRTC (en-US)に関連したAPIです。このAPIでは、オーディオやビデオデータのストリーム、これらを操作するためのメソッド、データタイプに関連づけられた制約、データを非同期に利用する際の成功と失敗のコールバック、これらの処理を行なっている最中に発生するイベントなどをサポートします。

基本概念

このAPIは、オーディオまたはビデオに関連づけられたデータの流れを表現するためのMediaStreamオブジェクトの操作を基本としています。例としてGet the video (en-US)(英語)をご覧ください。

MediaStreamは0個以上のMediaStreamTrackによって構成されます。MediaStreamTrackは様々なオーディオやビデオのトラックを表現します。それぞれのMediaStreamTrackは、1つ以上のチャンネルを持ちます。このチャンネルはメディアストリームの最小の単位を表現します。例えば、ステレオのオーディオトラックのleftrightのチャンネルのそれぞれのように、与えられたスピーカーに関連づけられたオーディオ信号です。

MediaStreamオブジェクトは、1つの入力と1つの出力を持ちます。MediaStreamオブジェクトは、ローカルで呼び出されるgetUserMedia()によって生成され、ユーザーのカメラやマイクの1つを入力ソースとして持ちます。ローカルでないMediaStreamは、<video><audio>などのメディア要素や、WebRTC RTCPeerConnection APIによって取得できるネットワーク越しに生成されたストリーム、Web Audio API (en-US) MediaStreamAudioSourceNode (en-US)によって作成されたストリームとして表現されます。MediaStreamオブジェクトの出力はコンシューマ(consumer)に接続されます。出力として<audio><video>などのメディア要素、WebRTC RTCPeerConnection API、Web Audio API (en-US) MediaStreamAudioDestinationNode (en-US)が使用できます。

 

リファレンス

ガイドとチュートリアル

能力、制約、そして設定
制約(constraints)と能力(capabilities)の双子の概念により、ブラウザーとウェブサイトまたはアプリは、ブラウザーの実装がサポートする制約可能なプロパティ(constrainable properties)と、それぞれに対してサポートする値に関する情報を交換できます。 この記事では、能力と制約およびメディアの設定について説明し、Example Constraint exerciser(Constraint Exerciser)と呼ばれる例を含みます。

ブラウザ互換性

BCD tables only load in the browser

関連項目