大网数据广告活动
Web 标准与前端开发

AudioNode

· 52CE 我爱测

音频源(如,HTML audio 或 video 元素,OscillatorNode,等等); - 音频地址; - 中间处理模块(如,类似 BiquadFilterNode 或 ConvolverNode 这样的滤波器);或 - 音量控制器(如 GainNode)。

Web Audio API

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

  • 音频源(如,HTML audio 或 video 元素,OscillatorNode,等等);
  • 音频地址;
  • 中间处理模块(如,类似 BiquadFilterNode 或 ConvolverNode 这样的滤波器);或
  • 音量控制器(如 GainNode)。

[!NOTE] 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 主页。

创建一个音频节点

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

// 构造函数
const analyserNode = new AnalyserNode(audioCtx, {
  fftSize: 2048,
  maxDecibels: -25,
  minDecibels: -60,
  smoothingTimeConstant: 0.5,
});
// 工场方法
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)。

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;

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。