| CARVIEW |
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
MediaStream
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年9月.
MediaStream はメディアキャプチャとストリーム API のインターフェイスで、メディアコンテンツのストリームを表します。ストリームは動画や音声など複数のトラックから成ります。それぞれのトラックは MediaStreamTrack のインスタンスとして定義されます。
MediaStream オブジェクトを取得するには、コンストラクターを使用するか MediaDevices.getUserMedia(), MediaDevices.getDisplayMedia(), HTMLCanvasElement.captureStream() などの関数を呼び出すかします。
コンストラクター
MediaStream()-
新しい
MediaStreamオブジェクトを作成して返します。空のストリーム、既存のストリームに基づいたストリーム、 (MediaStreamTrackオブジェクトの配列として指定して) 特定のトラックのリストを含むストリームを作成することができます。
インスタンスプロパティ
このインターフェイスは親である EventTarget からプロパティを継承しています。
MediaStream.active読取専用-
論理値で、
trueはMediaStreamがアクティブな時、falseはそうでない場合です。 MediaStream.id読取専用-
文字列で、 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()-
引数として与えられた
MediaStreamTrackを除去します。トラックがMediaStreamオブジェクトに含まれていなかった場合は、何もしません。
イベント
addtrack-
新しい
MediaStreamTrackオブジェクトが追加されたときに発行されます。 removetrack-
MediaStreamTrackオブジェクトが除去されたときに発行されます。 active非標準-
この MediaStream がアクティブになったときに発行されます。
inactive非標準-
この MediaStream がアクティブでなくなったときに発行されます。
仕様書
| Specification |
|---|
| Media Capture and Streams # mediastream |
ブラウザーの互換性
Loading…