Media Capture and Streams API (Media Streams)
Media Capture and Streams APIは一般的にMedia Stream APIやStream APIと呼ばれるWebRTCに関連したAPIです。このAPIでは、オーディオやビデオデータのストリーム、これらを操作するためのメソッド、データタイプに関連づけられた制約、データを非同期に利用する際の成功と失敗のコールバック、これらの処理を行なっている最中に発生するイベントなどをサポートします。
基本概念
このAPIは、オーディオまたはビデオに関連づけられたデータの流れを表現するためのMediaStreamオブジェクトの操作を基本としています。例としてGet the video(英語)をご覧ください。
MediaStreamは0個以上のMediaStreamTrackによって構成されます。MediaStreamTrackは様々なオーディオやビデオのトラックを表現します。それぞれのMediaStreamTrackは、1つ以上のチャンネルを持ちます。このチャンネルはメディアストリームの最小の単位を表現します。例えば、ステレオのオーディオトラックのleftとrightのチャンネルのそれぞれのように、与えられたスピーカーに関連づけられたオーディオ信号です。
MediaStreamオブジェクトは、1つの入力と1つの出力を持ちます。MediaStreamオブジェクトは、ローカルで呼び出されるgetUserMedia()によって生成され、ユーザーのカメラやマイクの1つを入力ソースとして持ちます。ローカルでないMediaStreamは、<video>や<audio>などのメディア要素や、WebRTC RTCPeerConnection APIによって取得できるネットワーク越しに生成されたストリーム、Web Audio API MediaStreamAudioSourceNode (en-US)によって作成されたストリームとして表現されます。MediaStreamオブジェクトの出力はコンシューマ(consumer)に接続されます。出力として<audio>や<video>などのメディア要素、WebRTC RTCPeerConnection API、Web Audio API MediaStreamAudioDestinationNode (en-US)が使用できます。
リファレンス
addtrack(event)AudioStreamTrackBlobEventended (en-US)(event)MediaStreamMediaStreamConstraintsMediaStreamEvent(en-US)MediaStreamTrackMediaStreamTrackEvent(en-US)MediaTrackCapabilitiesMediaTrackConstraints(en-US)MediaTrackSettings(en-US)MediaTrackSupportedConstraintsmuted(event)NavigatorUserMediaNavigatorUserMediaErroroverconstrained(event)removetrack(event)started(event)unmuted(event)URLVideoStreamTrack
ガイドとチュートリアル
- 能力、制約、そして設定
- 制約（constraints）と能力（capabilities）の双子の概念により、ブラウザーとウェブサイトまたはアプリは、ブラウザーの実装がサポートする制約可能なプロパティ（constrainable properties）と、それぞれに対してサポートする値に関する情報を交換できます。 この記事では、能力と制約およびメディアの設定について説明し、Example Constraint exerciser（Constraint Exerciser）と呼ばれる例を含みます。
ブラウザ互換性
BCD tables only load in the browser
関連項目
- WebRTC - APIの入門ページ
mediaDevices.getUserMedia()- Taking webcam photos:
getUserMedia()を用いたデモとチュートリアル