AudioNode

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.

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

AudioNode 接口是一个处理音频的通用模块,比如:

EventTarget AudioNode

备注: AudioNode 可以作为事件的目标,所以它实现了 EventTarget 接口。

属性

AudioNode.context 只读

返回关联的 BaseAudioContext,即代表节点参与的处理图的对象。

AudioNode.numberOfInputs 只读

返回节点的输入数。源节点被定义为 numberOfInputs 属性的值为 0 的节点。

AudioNode.numberOfOutputs 只读

返回节点输出的数量。目的节点(如 AudioDestinationNode)的这一属性的值为 0

AudioNode.channelCount

一个整数,用于确定在上混音和下混音中连接到节点的任何输入时使用了多少个通道。其用法和精确定义取决于 AudioNode.channelCountMode 的值。

AudioNode.channelCountMode

一个描述节点输入和输出之间必须匹配的通道方式的枚举值。

AudioNode.channelInterpretation

一个描述通道含义的枚举值。该数值将定义音频的上混音和下混音会怎样进行。可能的取值是 "speakers""discrete"

方法

还实现了接口 EventTarget 的方法

AudioNode.connect()

允许我们将此节点的输出连接到另一个节点(可以是音频数据,也可以是 AudioParam 的值)的输入。

AudioNode.disconnect()

允许我们断开当前节点与另一个已连接节点的连接。

描述

音频路由图

参与一个 AudioContext 中的 AudioNode 可以构成一个音频路由图。

每个 AudioNode 都有输入和输出,多个音频节点连接在一起构成一个处理图。这个图包含在一个 AudioContext 中,每个音频节点只能属于一个音频上下文。

源节点没有输入,但有一个或多个输出,可以用来生成声音。另一方面,目的节点没有输出;相反,它的所有输入直接在扬声器(或者音频上下文使用的任何音频输出设备)上播放。此外,还有处理节点,它们有输入和输出。不同的 AudioNode 之间的确切处理方式各不相同,但通常来说,节点会读取它的输入,进行一些与音频相关的处理,并为它的输出生成新值,或者让音频通过(例如在 AnalyserNode 中,处理的结果需要单独访问)。

图中的节点越多,延迟就越高。例如,如果你的图的延迟为 500 毫秒,当源节点播放声音时,你会需要等待半秒,才能在扬声器上听到声音(甚至可能因为底层音频设备的延迟而更长)。因此,如果你需要实现交互式音频,请使图尽可能的小,并将用户控制的音频节点放在图的末尾。例如,音量控制器(GainNode)应该是最后一个节点,以便音量更改立即生效。

每个输入和输出都有一定数量的通道。例如,单声道音频有一个通道,而立体声音频有两个通道。Web Audio API 将根据需要对通道数量进行上混音或下混音;请参阅 Web Audio 规范以获取详细信息。

有关所有音频节点的列表,请参阅 Web Audio API 主页。

创建一个音频节点

有两种可以创建音频节点的方法:通过构造函数和通过工厂方法

js
// 构造函数
const analyserNode = new AnalyserNode(audioCtx, {
  fftSize: 2048,
  maxDecibels: -25,
  minDecibels: -60,
  smoothingTimeConstant: 0.5,
});
js
// 工场方法
const analyserNode = audioCtx.createAnalyser();
analyserNode.fftSize = 2048;
analyserNode.maxDecibels = -25;
analyserNode.minDecibels = -60;
analyserNode.smoothingTimeConstant = 0.5;

你可以自由使用构造函数或工厂方法,也可以混合使用这两种方法,但使用构造函数有很多好处:

  • 所有参数都可以在构造时设置,而无需单独设置。
  • 可以对音频节点进行子类化。虽然实际处理是由浏览器内部完成的,无法更改,但你可以编写一个音频节点的包装器,以提供自定义属性和方法。
  • 略微提升性能:在 Chrome 浏览器和 Firefox 浏览器中,工厂方法会在内部调用构造函数。

简史:第一版 Web 音频规范仅定义了工厂方法。经过 2013 年 10 月的设计审查,决定添加构造函数,因为与工厂方法相比,前者有很多优点。在 2016 年 8 月至 10 月期间,构造函数被添加到规范中。工厂方法仍继续包含在规范中,并未废弃。

示例

这个简单的代码片段展示了一些音频节点的创建,以及如何使用 AudioNode 属性和方法。你可以在 Web Audio API 页面中的链接找到此类用法的示例(例如 Violent Theremin)。

js
const audioCtx = new AudioContext();

const oscillator = new OscillatorNode(audioCtx);
const gainNode = new GainNode(audioCtx);

oscillator.connect(gainNode).connect(audioCtx.destination);

oscillator.context;
oscillator.numberOfInputs;
oscillator.numberOfOutputs;
oscillator.channelCount;

规范

Specification
Web Audio API
# AudioNode

浏览器兼容性

BCD tables only load in the browser

参见