使用WAAClock精准调度Web MIDI时钟事件遇漂移问题求助

问题背景 #

我之前已经阅读并实现过Chris Wilson《A Tale of Two Clocks》一文中描述的类似方案，最近发现WAAClock理论上采用相同原理。我正在开发一款MIDI Web应用，需要精准调度MIDI时钟消息，目前使用WebMidiJS库，也在其论坛发布过相关帖子。核心代码如下：

const PULSES_PER_QUARTER_NOTE = 24;
const BPM_ONE_SECOND = 60;

let context = new AudioContext();
let clock = new WAAClock(context);

const calculateClockDelay = bpm => BPM_ONE_SECOND  / bpm /  PULSES_PER_QUARTER_NOTE; 

const startMidiClock = bpm => {
    clock.start();

    clock.callbackAtTime(function () {
        WebMidi.outputs.forEach(outputPort => outputPort.sendClock({}));
    }, 0).repeat(calculateClockDelay(bpm));
}

const stopMidiClock = () =>  clock.stop();

目前遇到的问题是无法实现高精度事件调度，BPM仪表出现轻微漂移，但用DAW发送MIDI时钟时计时完全准确，且我已在clock.callbackAtTime函数中设置零容差，现提出以下疑问：

1. 为何会出现这种漂移/轻微调度误差？
2. 使用WAAClock是否有其他方法可精准调度重复MIDI事件？
3. WAAClock能否达到与Chris Wilson技术相同的精准调度水平？

问题解答 #

1. 漂移产生的原因 #

• 累积误差：WAAClock的repeat方法默认基于上一次回调的实际触发时间计算下一次执行点，而非严格按初始间隔累加。如果某次回调因主线程阻塞（如JS任务队列繁忙）延迟，后续所有调度都会偏移，长期下来形成累积漂移。
• 浮点数精度损耗：计算calculateClockDelay时的浮点数除法，多次累加后会出现精度损失，导致实际间隔与理论值的偏差不断放大。
• WebMidiJS发送延迟：sendClock底层处理存在微小异步延迟，遍历多个输出端口时会占用主线程时间，进一步干扰调度精度。

2. WAAClock精准调度的优化方法 #

• 基于音频时钟手动校准：放弃repeat的自动累加，每次回调时以context.currentTime为基准计算下一次调度时间，确保锚点始终对齐音频时钟：

  const startMidiClock = bpm => {
      clock.start();
      const interval = calculateClockDelay(bpm);
  
      const sendClockTick = () => {
          // 提前缓存输出端口，避免每次遍历
          outputPorts.forEach(port => port.sendClock({}));
          clock.callbackAtTime(sendClockTick, context.currentTime + interval);
      };
  
      // 初始化输出端口缓存
      const outputPorts = [...WebMidi.outputs];
      sendClockTick();
  };
  

• 减轻主线程负载：提前缓存输出端口列表，避免每次回调都遍历WebMidi.outputs；若需处理大量端口，可将发送逻辑拆分为微任务，但要确保不影响调度时间。
• 调整WAAClock精度配置：检查WAAClock构造参数，确保启用最高精度模式（部分版本支持通过容差参数控制调度精度）。

3. WAAClock与Chris Wilson技术的精度对比 #

WAAClock核心原理和Chris Wilson的方案一致，都是基于Web Audio API的AudioContext时钟调度事件，理论上可以达到相同精度。实际差异来自：

• WAAClock是封装库，内部有额外逻辑（如容差处理、队列管理），配置不当会引入额外延迟。
• Chris Wilson的方案是手动实现底层调度，开发者可完全控制时间计算和回调细节，更容易做到极致精度。
  只要正确配置WAAClock并采用手动时间校准，就能达到与Chris Wilson技术相当的调度精度。

内容的提问来源于stack exchange，提问作者Danny Bullo