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

AudioWorkletNode

· 52CE 我爱测

虽然这个接口可以在 secure contexts 之外调用,但是 BaseAudioContext.audioWorklet 属性不行,从而 AudioWorkletProcessor 不能在外部定义。

Web Audio API

虽然这个接口可以在 secure contexts 之外调用,但是 BaseAudioContext.audioWorklet 属性不行,从而 AudioWorkletProcessor 不能在外部定义。

Web Audio API 中的 AudioWorkletNode 接口代表了用户定义的AudioNode的基类,该基类可以与其他节点一起连接到音频路由图。其具有关联的AudioWorkletProcessor, 它在 Web Audio 执行实际的音频处理。

构造函数

  • AudioWorkletNode.AudioWorkletNode
    • : 为 AudioWorkletNode 创建一个新的实例对象。

属性

也继承父类的属性,AudioNode.

  • AudioWorkletNode.port
    • : 返回一个 MessagePort 用于节点与其关联的 AudioWorkletProcessor 间的双向通讯。另一端在处理器属性AudioWorkletProcessor.port 下可用。
  • AudioWorkletNode.parameters
    • : 返回一个 AudioParamMap — AudioParam 对象的集合。它们在创建 AudioWorkletProcessor的过程中被实例化。如果 AudioWorkletProcessor 有一个静态的 AudioWorkletProcessor.parameterDescriptors getter,从其返回的 AudioParamDescriptor 数组用于在 AudioWorkletNode 创建 AudioParam 对象。通过这种机制,使得 AudioParam 对象可以从 AudioWorkletNode 中访问。你可以在与其关联的 AudioWorkletProcessor 中使用它的值。

Event handlers

  • AudioWorkletNode.onprocessorerror
    • : 在关联的 AudioWorkletProcessor 对象发生异常时触发。一旦触发,处理器及其节点将在其整个生命周期内处于输出静默状态。

方法

同样继承了其父类的方法,AudioNode.

AudioWorkletNode 接口未定义其自己的任何方法。

示例

在本示例中我们创建了 AudioWorkletNode 对象,它会输出白噪声。

首先,我们需要定义一个自定义的 AudioWorkletProcessor, 它将输出白噪声并进行注册。注意,这需要在一个单独的文件中完成。

// white-noise-processor.js
class WhiteNoiseProcessor extends AudioWorkletProcessor {
  process(inputs, outputs, parameters) {
    const output = outputs[0];
    output.forEach((channel) => {
      for (let i = 0; i < channel.length; i++) {
        channel[i] = Math.random() * 2 - 1;
      }
    });
    return true;
  }
}

registerProcessor("white-noise-processor", WhiteNoiseProcessor);

接下来,在脚本主文件中一个 AudioWorkletNode 实例,并传递处理器的名称,然后将该实例连接到一个 audio graph.

const audioContext = new AudioContext();
await audioContext.audioWorklet.addModule("white-noise-processor.js");
const whiteNoiseNode = new AudioWorkletNode(
  audioContext,
  "white-noise-processor",
);
whiteNoiseNode.connect(audioContext.destination);

规范

浏览器兼容性

See also

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

资料来源与适用范围

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

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

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