Web Audio API纯输出型AudioWorkletProcessor如何获取可靠样本时间戳
AudioWorkletProcessor 单帧内样本精确时间戳获取方案
不可靠的常见实现思路
- 直接复用主线程的
audioCtx.currentTime:该值属于主线程沙箱内的暴露时钟,为防范时序攻击和指纹追踪会被浏览器主动截断精度,且跨线程传输存在调度延迟,与AudioWorklet线程内的实际样本输出时序存在天然偏差,无法用来定位单帧内的样本时间。 - 自维护运行计数器搭配采样率推算时间:该方案完全依赖计算无掉帧、调度顺序完全固定的理想前提,一旦出现线程抢占、处理帧动态调整、缓冲区补帧等异常情况,累计误差会不断放大,长期运行必然出现时间漂移。
框架内置的可靠时间源
绝大多数公开示例都忽略了AudioWorklet规范本身提供的原生能力:AudioWorkletProcessor 的 process() 回调被触发时,浏览器会直接传入一个与当前处理块绑定的高精度时间参数,该值的生成全程在实时音频线程内完成,不受主线程的精度截断规则影响。
传入的时间戳代表当前处理块中第一个样本被输出到音频硬件的精确时间点,与硬件输出时基严格对齐。
单帧内任意索引位置的样本时间可通过简单计算得到:
- 设当前处理块传入的原生时间戳为
blockStartTimestamp,块内第i个样本的索引(从0开始计数)为sampleIndex,上下文采样率为sampleRate - 对应样本的精确生成时间为:
sampleTime = blockStartTimestamp + sampleIndex / sampleRate
方案可靠性说明
该方案完全规避了自定义推算的累计误差问题,不需要依赖无掉帧、调度顺序固定的理想假设:
- 时间值生成全程在AudioWorklet实时线程内闭环完成,不会经过主线程的安全沙箱做精度截断,从根源上解决了主线程时钟精度不足的问题
- 每个处理块的起始时间由浏览器直接基于硬件时基给出,就算出现临时调度延迟、帧大小调整、甚至上一帧处理超时的情况,浏览器传入的下一个处理块的时间戳也会直接重置为与硬件输出对齐的实际值,不会延续之前的计数错误
- 属于Web Audio API规范定义的标准能力,不存在浏览器兼容层面的非标准hack风险
使用注意事项
- 纯输出类音频逻辑完全不需要将Worklet线程内的时间戳与主线程的
currentTime做强制对齐,两个时钟出于安全设计本身就做了时基隔离,跨线程对齐反而会引入不必要的精度损失 - 音频设备的固定输出延迟与缓冲区大小是绑定常量,如需对齐人耳实际听到的声音时间,可在初始化阶段通过短脉冲测量得到固定偏移量,后续做统一补偿即可,不会产生随时间累积的漂移误差
内容的提问来源于stack exchange,提问作者Jacob
相关产品推荐
相关产品推荐

