HTML | AudioContext baseLatency 属性

baseLatency是Web Audio API中的一个属性，表示音频硬件与运行Web Audio API的计算机之间的延迟时间（以秒为单位）。这个值是只读的，并且以浮点格式返回。

语法

const audioCtx = new AudioContext();
const latency = audioCtx.baseLatency;

描述

在Web Audio API中，每个AudioContext对象都有一个baseLatency属性。这个属性用于确定Web Audio API生成的音频流与运行Web Audio API的计算机上的音频硬件之间的延迟。

baseLatency属性的值反映了硬件和软件调用之间的时间差。这个值根据音频硬件和操作系统的不同而不同，但通常是介于1.5毫秒到10毫秒之间。在Windows上，这个值较高。

使用baseLatency可以帮助我们更好地同步音频和图形操作。例如，在对象运动的过程中，我们可以使用该属性预测正确的布局。

需要注意的是，虽然baseLatency是只读属性，但创建AudioContext时可以通过传入参数来更改它。这个参数是一个可选的AudioContextOptions对象，可以包含latencyHint属性，该属性可以为interactive，playback或balanced三个值之一，以指定优先考虑较低延迟还是更好的CPU使用率。

const audioCtx = new AudioContext({ latencyHint: 'playback' });

默认情况下，latencyHint为balanced，这意味着AudioContext将根据所提供的音频数据类型和输入设备选择最佳的延迟。

示例

以下是使用baseLatency属性设置并计算延迟的示例代码：

const audioCtx = new AudioContext();
const oscillator = audioCtx.createOscillator();
oscillator.type = 'sine';
oscillator.frequency.value = 261.63;
const delayTime = audioCtx.currentTime + audioCtx.baseLatency;
oscillator.start();
oscillator.stop(delayTime + 1);

在这个例子中，我们创建了一个频率为261.63赫兹的正弦波振荡器，并在AudioContext.currentTime基础上加上baseLatency计算出一个延迟。然后，我们调用start()方法开始振荡器，并在延迟时间加上1秒后调用stop()方法。

结论

baseLatency是一个只读属性，用于确定Web Audio API生成的音频流与运行Web Audio API的计算机上的音频硬件之间的延迟。在Web应用程序中，使用该属性可以更好地同步音频和图形操作，并提供更流畅的用户体验。