Get to know MDN better
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年9月.
MediaStreamAudioSourceNode インターフェイスは AudioNode の一種で、WebRTC またはメディアキャプチャとストリーム API で取得した MediaStream から音声を取得する音源として働きます。
音声は、(getUserMedia() 経由の) マイクから得られたものも使用できますし、(RTCPeerConnection の音声トラックを用いた) WebRTC による通話相手から受信したものも使用できます。
MediaStreamAudioSourceNode は入力を持たず、出力をちょうど 1 個持ちます。また、AudioContext.createMediaStreamSource() メソッドにより作成されます。
MediaStreamAudioSourceNode は kind 属性の値が audio である 最初の MediaStreamTrack から音声を取得します。トラックの順番について詳しくはトラックの順序付けを参照してください。
このノードの出力のチャンネル数は、選択された音声トラックで見つかったトラックの数と一致します。
EventTarget AudioNode MediaStreamAudioSourceNode| 0 |
| 1 |
| 2 (ただし、AudioNode.channelCount は AudioNode の入力のアップミキシングおよびダウンミキシングにのみ用いられ、MediaStreamAudioSourceNode は入力を持ちません) |
指定したオプションを用いて新しい MediaStreamAudioSourceNode オブジェクトを作成します。
以下のプロパティに加え、MediaStreamAudioSourceNode は親の AudioNode からプロパティを継承します。
mediaStream 読取専用この MediaStreamAudioSourceNode の生成時に用いられた MediaStream です。
親の AudioNode からメソッドを継承します。
引数 mediaStream により指定されたストリームに音声トラックが無いとき投げられます。
MediaStreamTrackAudioSourceNode インターフェイスでは、ストリーム内の音声トラックの順番は、kind が audio であるトラックを抽出し、抽出したトラックを id プロパティの値の Unicode のコードポイント順 (本質的には、ID が単純なアルファベットからなる文字列のときはアルファベット順 (辞書順)) でソートすることで決定されます。
そして、最初の トラックとは、トラックの ID が Unicode のコードポイント順でソートされたとき id が最初に来るトラックのことです。
しかし、重要な点として、この順序付けを確立するルールは、このインターフェイスが最初に Web Audio API に追加されてからだいぶ後に追加されました。そのため、この順序付けがどの 2 種類のブラウザーやブラウザーのバージョンでも同じになるとして簡単に依存することはできません。
MediaStreamTrackAudioSourceNode インターフェイスは MediaStreamAudioSourceNode に似ていますが、使用するトラックを指定できるようにすることでこの問題を回避しています。
このオブジェクトを使用するコードの例は、AudioContext.createMediaStreamSource() を参照してください。
| Web Audio API # MediaStreamAudioSourceNode |
Enable JavaScript to view this browser compatibility table.
This page was last modified on 2024年4月28日 by MDN contributors.
Your blueprint for a better internet.
Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.