このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
メディアキャプチャとストリーム API (メディアストリーム)
メディアキャプチャとストリーム API (Media Capture and Streams API) は、一般的にメディアストリーム API (Media Stream API または MediaStream API) と呼ばれ、音声や映像のデータのストリーミングへの対応を提供するWebRTC に関連した API です。
これは、ストリームとその構成トラックを操作するためのインターフェイスとメソッド、データ形式に関連する制約、データを非同期に使用する際の成功とエラーのコールバック、および処理中に発行されるイベントを提供するものです。
基本概念
この API は、音声または映像に関連づけられたデータの流れを表現するためのMediaStream オブジェクトの操作を基本としています。例としてメディアストリームの取得をご覧ください。
MediaStream は 0 個以上のMediaStreamTrack によって構成されます。これは様々な音声や映像のトラックを表現します。それぞれのMediaStreamTrack は、1 つ以上のチャンネルを持ちます。このチャンネルはメディアストリームの最小の単位を表現します。例えば、ステレオの音声トラックの左と右のチャンネルのそれぞれのように、与えられたスピーカーに関連づけられた音声信号です。
MediaStream オブジェクトは、1 つの入力と 1 つの出力を持ちます。MediaStream オブジェクトは、ローカルで呼び出されるgetUserMedia() によって生成され、ユーザーのカメラやマイクの 1 つを入力ソースとして持ちます。ローカルでないMediaStream は、<video> や<audio> などのメディア要素や、WebRTCRTCPeerConnection API によって取得できるネットワーク越しに生成されたストリーム、ウェブオーディオ API のMediaStreamAudioDestinationNode によって作成されたストリームとして表現されます。
MediaStream オブジェクトの出力はコンシューマー (consumer) に接続されます。出力として<audio> や<video> などのメディア要素、 WebRTCRTCPeerConnection API、ウェブオーディオ API のMediaStreamAudioSourceNodeが使用できます。
インターフェイス
これらのリファレンス記事では、メディアキャプチャとストリーム API を構成する各インターフェイスについて知っておく必要がある基本的な情報を見つけられます。
CanvasCaptureMediaStreamTrackInputDeviceInfoMediaDeviceKindMediaDeviceInfoMediaDevicesMediaStreamMediaStreamEventMediaStreamTrackMediaStreamTrackEventMediaTrackCapabilitiesMediaTrackConstraintsMediaTrackSettingsMediaTrackSupportedConstraintsNavigatorUserMediaNavigatorUserMediaErrorOverconstrainedErrorURL
イベント
ガイドとチュートリアル
能力と制約と設定の記事では、制約と能力、メディア設定の概念について説明しています。また、制約エクササイザ―を記載しており、コンピューターの A/V 入力機器（ウェブカメラやマイクなど）からの音声と映像のトラックに対して異なる制約集合を適用した結果を試してみることができます。
getUserMedia() による写真の撮影 の記事では、getUserMedia() を使用して、getUserMedia() に対応しているコンピューターや携帯電話のカメラにアクセスし、それで写真を撮る方法を示しています。
ブラウザーの互換性
api.MediaStream
api.MediaStreamTrack
api.MediaDevices
api.MediaDeviceInfo
api.InputDeviceInfo
api.CanvasCaptureMediaStreamTrack
関連情報
- WebRTC - API の入門ページ
mediaDevices.getUserMedia()- WebRTC による写真の撮影:
getUserMedia()を用いたデモとチュートリアル