MediaStreamAudioSourceNode

コンストラクター

new MediaStreamAudioSourceNode()

指定したオプションを用いて新しい MediaStreamAudioSourceNode オブジェクトを作成します。

インスタンスプロパティ

以下のプロパティに加え、MediaStreamAudioSourceNode は親の AudioNode からプロパティを継承します。

mediaStream 読取専用

この MediaStreamAudioSourceNode の生成時に用いられた MediaStream です。

インスタンスメソッド

親の AudioNode からメソッドを継承します。

例外

InvalidStateError DOMException

引数 mediaStream により指定されたストリームに音声トラックが無いとき投げられます。

使用時の注意

トラックの順序付け

MediaStreamTrackAudioSourceNode インターフェイスでは、ストリーム内の音声トラックの順番は、kind が audio であるトラックを抽出し、抽出したトラックを id プロパティの値の Unicode のコードポイント順 (本質的には、ID が単純なアルファベットからなる文字列のときはアルファベット順 (辞書順)) でソートすることで決定されます。

そして、最初の トラックとは、トラックの ID が Unicode のコードポイント順でソートされたとき id が最初に来るトラックのことです。

しかし、重要な点として、この順序付けを確立するルールは、このインターフェイスが最初に Web Audio API に追加されてからだいぶ後に追加されました。そのため、この順序付けがどの 2 種類のブラウザーやブラウザーのバージョンでも同じになるとして簡単に依存することはできません。

MediaStreamTrackAudioSourceNode インターフェイスは MediaStreamAudioSourceNode に似ていますが、使用するトラックを指定できるようにすることでこの問題を回避しています。

例

このオブジェクトを使用するコードの例は、AudioContext.createMediaStreamSource() を参照してください。

仕様書

ブラウザーの互換性

関連情報

• ウェブオーディオ API の使用
• WebRTC API
• メディアキャプチャとストリーム API (メディアストリーム)
• MediaStreamTrackAudioSourceNode