PannerNode: PannerNode() コンストラクター
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
PannerNode()
はウェブオーディオ API のコンストラクターで、新しい PannerNode
オブジェクトインスタンスを生成します。
構文
new PannerNode(context)
new PannerNode(context, options)
引数
context
-
ノードを関連付けたい音声コンテキストを表す
BaseAudioContext
です。 options
省略可-
PannerNode
に設定したいプロパティを定義するPannerOptions
辞書オブジェクトです。panningModel
-
PannerNode
に設定したいPannerNode.panningModel
(既定値はequalpower
です。) distanceModel
-
PannerNode
に設定したいPannerNode.distanceModel
(既定値はinverse
です。) positionX
-
PannerNode
に設定したいPannerNode.positionX
(既定値は0
です。) positionY
-
PannerNode
に設定したいPannerNode.positionY
(既定値は0
です。) positionZ
-
PannerNode
に設定したいPannerNode.positionZ
(既定値は0
です。) orientationX
-
PannerNode
に設定したいPannerNode.orientationX
(既定値は1
です。) orientationY
-
PannerNode
に設定したいPannerNode.orientationY
(既定値は0
です。) orientationZ
-
PannerNode
に設定したいPannerNode.orientationZ
(既定値は0
です。) refDistance
-
PannerNode
に設定したいPannerNode.refDistance
です。既定値は1
であり、負の値は許可されません。 maxDistance
-
PannerNode
に設定したいPannerNode.maxDistance
です。既定値は10000
であり、正でない値は許可されません。 rolloffFactor
-
PannerNode
に設定したいPannerNode.rolloffFactor
です。既定値は1
であり、負の値は許可されません。 coneInnerAngle
-
PannerNode
に設定したいPannerNode.coneInnerAngle
(既定値は360
です。) coneOuterAngle
-
PannerNode
に設定したいPannerNode.coneOuterAngle
(既定値は360
です。) coneOuterGain
-
PannerNode
に設定したいPannerNode.coneOuterGain
です。既定値は0
であり、値は 0 ~ 1 の範囲を取ることができます。 channelCount
-
ノードへの任意の入力へのアップミキシングとダウンミキシング接続時に使用するチャンネル数を決定するための整数を表します。(詳細は
AudioNode.channelCount
を参照してください。)使用法と正確な定義はchannelCountMode
の値に依存します。 channelCountMode
-
ノードの入出力間でチャンネルを照合する方法を記述する列挙値を表します。(既定値を含む詳細は
AudioNode.channelCountMode
を参照してください。) channelInterpretation
-
チャンネルの意味を記述する列挙値を表します。この解釈によって、音声のアップミキシングやダウンミキシングがどのように行われるかを定義します。可能な値は "speakers" または "discrete" です。(既定値を含む詳細は
AudioNode.channelCountMode
を参照してください。)
例外
RangeError
-
refDistance
、maxDistance
、rolloffFactor
プロパティに受け入れられる範囲外の値が指定された場合に発生します。 InvalidStateError
DOMException
-
coneOuterGain
プロパティに受け入れられる範囲外 (0 ~ 1) の値が指定された場合に発生します。
例
const ctx = new AudioContext();
const options = {
positionX: 1,
maxDistance: 5000,
};
const myPanner = new PannerNode(ctx, options);
仕様書
Specification |
---|
Web Audio API # dom-pannernode-pannernode |