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 の作成をご覧ください。

構文

js
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