OscillatorNode: OscillatorNode() コンストラクター
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.
OscillatorNode()
は ウェブオーディオ API のコンストラクターで、正弦波のような周期的な波形を表現する AudioNode
オブジェクトを新しく作成し、オプションでノードのプロパティの値を指定したオブジェクトの値に合わせて設定することができます。
プロパティの既定値が受け入れられる場合 は、代わりに BaseAudioContext.createOscillator()
ファクトリーメソッドを任意で使用することができます。 AudioNode の作成をご覧ください。
構文
new OscillatorNode(context, options)
引数
context
-
AudioContext
への参照です。 options
省略可-
この発振器ノードのプロパティの初期値を指定するオブジェクトです。プロパティがオブジェクトから省略されると、ドキュメントにある通りの既定値を受け取ります。
type
-
ノードが生成する波形を指定します。有効な値は '
sine
', 'square
', 'sawtooth
', 'triangle
', 'custom
'です。既定値は 'sine
' です。 detune
-
指定された量だけ
frequency
をずらす離調値(セント単位)です。既定値では 0 です。 frequency
-
周期的な波形の周波数(単位はヘルツ)です。既定で 440 です。
periodicWave
-
任意の周期の波形を
PeriodicWave
オブジェクトで記述したものです。 channelCount
-
ノードへの任意の入力にアップミキシングおよびダウンミキシング接続するときに、何チャンネル使用するかを決めるために使用する整数を表わします。(詳細は
AudioNode.channelCount
を参照してください)。その使用方法と正確な定義はchannelCountMode
の値に依存します。 channelCountMode
-
ノードの入力と出力の間でチャンネルを照合する方法を記述する列挙型の値を表します。(既定値を含む詳細な情報は
AudioNode.channelCountMode
を参照してください。) channelInterpretation
-
チャンネルの意味を記述する列挙値を表します。この解釈により、音声のアップミキシングとダウンミキシングがどう行われるかを定義します。 使用可能な値は
"speakers"
または"discrete"
です。(既定値を含む詳細な情報はAudioNode.channelCountMode
を参照してください。)
返値
新しい OscillatorNode
オブジェクトのインスタンスです。
仕様書
Specification |
---|
Web Audio API # dom-oscillatornode-oscillatornode |
ブラウザーの互換性
BCD tables only load in the browser