OscillatorNode.type

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.

type は OscillatorNode インターフェイスのプロパティで、発振器が出力する波形の形状を指定します。利用できる一般的な波形がいくつかあり、カスタム波形を指定するオプションもあります。波形は、生成される音色に影響を与えます。

値

発振器の波形を指定する文字列です。利用できる値は以下のとおりです。

sine

正弦波です。これが既定値です。

square

矩形波で、デューティサイクルが 0.5 のものです。すなわち、それぞれの周期で半分が「高」の信号です。

sawtooth

のこぎり波です。

triangle

三角波です。

custom

カスタム波形です。手動で type を custom に設定することはありません。代わりに setPeriodicWave() メソッドを使用して、波形を表すデータを使用してください。そうすることで、自動的に type が custom に設定されます。

例外

InvalidStateError DOMException

値 custom が指定された場合に発生します。カスタム波形を設定するには setPeriodicWave() を呼び出すだけです。そうすることで、自動的に型が設定されます。

例

以下の例は、発振器ノードを作成するための AudioContext の基本的な使用方法を示しています。応用例については、 Violent Theremin demo を見てみてください。（関連するコードは app.js を参照）。

js
// create web audio api context
const audioCtx = new (window.AudioContext || window.webkitAudioContext)();

// create Oscillator node
const oscillator = audioCtx.createOscillator();

oscillator.type = "square";
oscillator.frequency.setValueAtTime(440, audioCtx.currentTime); // value in hertz
oscillator.start();

仕様書

Specification
Web Audio API
# dom-oscillatornode-type

ブラウザーの互換性

BCD tables only load in the browser

関連情報