MediaStream
MediaStream インターフェイスは、メディアコンテンツのストリームを表します。ストリームは動画や音声など複数のトラックから成ります。それぞれのトラックは MediaStreamTrack のインスタンスとして定義されます。
MediaStream オブジェクトを取得するには、コンストラクターを使用するか MediaDevices.getUserMedia(), MediaDevices.getDisplayMedia(), HTMLCanvasElement.captureStream() などの関数を呼び出すかします。
ユーザーエージェントによっては、このインターフェイスを CanvasCaptureMediaStreamTrack のようにサブクラス化して、より詳細な情報や機能を提供しています。
コンストラクター
MediaStream()-
新しい MediaStream オブジェクトを作成して返します。空のストリーム、既存のストリームに基づいたストリーム、 (
MediaStreamTrackオブジェクトの配列として指定して) 特定のトラックのリストを含むストリームを作成することができます。
プロパティ
このインターフェイスは親である EventTarget からプロパティを継承しています。
MediaStream.active読取専用-
論理値で、
trueはMediaStreamがアクティブな時、falseはそうでない場合です。 MediaStream.id読取専用-
DOMStringで 36 文字のオブジェクトの汎用一意識別子 (UUID) を表す文字列が入ります。
メソッド
このインターフェイスは親である EventTarget からメソッドを継承しています。
MediaStream.addTrack()-
引数で指定された
MediaStreamTrackのコピーを格納します。トラックが既にMediaStreamオブジェクトに追加されていた場合は、何も起こりません。
MediaStream.clone()-
MediaStreamオブジェクトの複製を返します。ただし、複製は固有のidの値を持ちます。
MediaStream.getAudioTracks()-
MediaStreamTrackオブジェクトのリストで、MediaStreamオブジェクトに格納されているものの中でkind属性がaudioに設定されているものを返します。順序は未定義であり、ブラウザーによって異なるばかりでなく、呼び出し毎に異なる可能性もあります。
MediaStream.getTrackById()-
引数
trackidで与えられた ID を持つトラックを返します。引数が与えられなかった場合や、その ID を持つトラックが存在しなかった場合は、nullを返します。複数のトラックが同じ ID を持っている場合は、最初の一つを返します。 MediaStream.getTracks()-
MediaStreamTrackオブジェクトのリストで、 MediaStream オブジェクトに格納されているものをすべて、kind属性の値に関わらず返します。順序は未定義であり、ブラウザーによって異なるばかりでなく、呼び出し毎に異なる可能性もあります。
MediaStream.getVideoTracks()-
MediaStreamTrackオブジェクトのリストで、 MediaStream オブジェクトに格納されているものの中で kind 属性が video に設定されているものを返します。順序は未定義であり、ブラウザーによって異なるばかりでなく、呼び出し毎に異なる可能性もあります。
MediaStream.removeTrack()(en-US)-
引数として与えられた
MediaStreamTrackを除去します。トラックがMediaStreamオブジェクトに含まれていなかった場合は、何もしません。
イベント
addtrack-
新しい
MediaStreamTrackオブジェクトが追加されたときに発行されます。 removetrack-
MediaStreamTrackオブジェクトが除去されたときに発行されます。
active-
この MediaStream がアクティブになったときに発行されます。
inactive-
この MediaStream がアクティブでなくなったときに発行されます。
仕様書
| Specification |
|---|
| Media Capture and Streams # mediastream |
ブラウザーの互換性
BCD tables only load in the browser