AudioWorklet：实时音频处理与延迟控制

---

title: AudioWorklet：实时音频处理与延迟控制

keywords:

• AudioWorklet
• AudioWorkletNode
• registerProcessor
• 实时处理
• 延迟优化

description: 使用 AudioWorklet 在独立线程进行实时音频处理，降低主线程干扰并实现稳定低延迟管线，附基础处理器与节点示例。

categories:

• 应用软件
• 音乐软件

---

概述

AudioWorklet 允许将音频处理迁移至专用上下文，提供更稳定的低延迟处理能力。通过 audioWorklet.addModule 注册处理器并在图中使用 AudioWorkletNode。

用法/示例

const ctx = new AudioContext()
await ctx.audioWorklet.addModule('/meter.js')
const meter = new AudioWorkletNode(ctx, 'meter')
meter.port.onmessage = e => { const v = e.data }
const src = ctx.createMediaElementSource(document.querySelector('audio'))
src.connect(meter).connect(ctx.destination)

// meter.js
class MeterProcessor extends AudioWorkletProcessor {
  process(inputs) {
    const input = inputs[0][0] || new Float32Array(0)
    let s = 0
    for (let i = 0; i < input.length; i++) s += input[i] * input[i]
    const rms = Math.sqrt(s / (input.length || 1))
    this.port.postMessage(rms)
    return true
  }
}
registerProcessor('meter', MeterProcessor)

工程建议

• 控制处理负载，避免在单次 process 中执行大量同步计算；必要时分片。
• 对设备与采样率差异进行适配，避免缓冲大小不一致导致的抖动。
• 管理节点与端口生命周期，确保释放与错误处理。

参考与验证

• MDN：AudioWorklet — https://developer.mozilla.org/docs/Web/API/AudioWorklet
• Web Audio API 规范 — https://www.w3.org/TR/webaudio/
• web.dev：AudioWorklet — https://web.dev/articles/audio-worklet