增益节点

基线 广泛可用

此功能已完善,可在许多设备和浏览器版本上运行。它已在以下浏览器中可用: 2021 年 4 月.

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

增益是一个无量纲的值,它随时间变化,并乘以所有输入通道的每个对应样本。如果修改,新增益会立即应用,这会导致输出音频中出现不美观的“咔嗒”声。为了防止这种情况发生,不要直接更改值,而是使用 AudioParam 接口上的指数插值方法。

The GainNode is increasing the gain of the output.

EventTarget AudioNode GainNode
输入数 1
输出数 1
通道计数模式 "最大"
通道计数 2(在默认计数模式下未使用)
通道解释 "扬声器"

构造函数

GainNode()

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

实例属性

从其父级 AudioNode 继承属性.

GainNode.gain 只读

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

实例方法

没有特定方法;从其父级 AudioNode 继承方法.

示例

请参阅 BaseAudioContext.createGain(),了解示例代码,该代码演示如何使用 AudioContext 创建 GainNode

规范

规范
Web Audio API
# 增益节点

浏览器兼容性

BCD 表只在浏览器中加载

另请参阅