OscillatorNode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

OscillatorNode 接口表示一个振荡器，它产生一个周期的波形信号（如正弦波）。它是一个AudioScheduledSourceNode 音频处理模块，这个模块会生成一个指定频率的波形信号（即一个固定的音调）

一个OscillatorNode 对象是通过AudioContext.createOscillator() 方法创建的。它总是有一个输出，但没有输入。它的基础属性（定义见AudioNode ）默认如下：

Number of inputs	`0`
Number of outputs	`1`
Channel count mode	`max`
Channel count	`2` (not used in the default count mode)
Channel interpretation	`speakers`

构造函数

OscillatorNode(): 创建一个 OscillatorNode 对象的示例，为 node属性提供可选的一个定义默认值的对象。如果默认值可接受，你可以简单地调用AudioContext.createOscillator()工厂方法。

属性

继承自父类AudioScheduledSourceNode，并添加下列属性：

OscillatorNode.frequency: 一个a-rate AudioParam 对象的属性代表了振动的频率（单位为赫兹 hertz） (虽然返回的AudioParam 是只读的，但是它所表示的值是可以修改的)。默认值是 440 Hz (基本的中 A 音高).
OscillatorNode.detune: 一个a-rate AudioParam 对象的属性代表振动的音高微调（单位是 cent 音分） (虽然返回的AudioParam 是只读的，但是它所表示的值是可以修改的).。默认值是 0。
OscillatorNode.type: 一个字符串，决定OscillatorNode 播放的声音的周期波形; 它的值可以是基础值中的一个或者用户使用PeriodicWave。不同的波形可以产生不同的声调。基础值有"sine"、"square"、"sawtooth"、"triangle" 和"custom"。默认值是"sine"。

方法

继承自父级，AudioScheduledSourceNode, 自有方法如下：

OscillatorNode.setPeriodicWave(): 设置一个PeriodicWave ,它描述了一个周期的波形常常替代标准波形之一; 调用这个方法来设置用户自定义的波形。它取代了已经废弃了的OscillatorNode.setWaveTable() 方法。

示例

下面示例展示了AudioContext 的基本使用来创建一个 oscillator 节点并使用它来播放音乐。这是已经在运行的例子，可以看这里Violent Theremin demo (see app.js 是相关代码).

// create web audio api contextvar audioCtx = new (window.AudioContext || window.webkitAudioContext)();// create Oscillator nodevar oscillator = audioCtx.createOscillator();oscillator.type = "square";oscillator.frequency.value = 440; // value in hertzoscillator.connect(audioCtx.destination);oscillator.start();