GainNode

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

GainNode 接口代表音量的变化。它是一个 AudioNode 音频处理模块,在输入数据传播到输出之前,会对输入数据应用指定的增益。GainNode 始终只有一个输入和一个输出,两者具有相同数量的通道。

增益是一个无单位的值,随时间变化,它乘以所有输入通道的每个相应样本。如果修改,新的增益会立即应用,从而在生成的音频中产生不悦耳的“咔哒”声。为避免这种情况发生,切勿直接修改该值,而应使用 AudioParam 接口上的指数插值方法。

The GainNode is increasing the gain of the output.

EventTarget AudioNode GainNode
输入数量 1
输出数量 1
通道计数模式 "max"
声道数 2 (在默认计数模式下未使用)
通道解释 “speakers”

构造函数

GainNode()

创建并返回一个新的 GainNode 对象。作为替代,您可以使用 BaseAudioContext.createGain() 工厂方法;请参阅 创建 AudioNode

实例属性

继承自其父级 AudioNode 的属性.

GainNode.gain 只读

一个 a-rate AudioParam,表示要应用的增益量。您必须设置 AudioParam.value 或使用 AudioParam 的方法来更改增益效果。

实例方法

无特定方法;继承自其父级 AudioNode 的方法.

示例

请参阅 BaseAudioContext.createGain() 了解使用 AudioContext 创建 GainNode 的示例代码。

规范

规范
Web Audio API
# GainNode

浏览器兼容性

另见