如何获取设备音频采样率 HTML5 AudioContext SampleRate用法详解

如何通过HTML5 AudioContext的SampleRate属性获取设备音频采样率

在Web音频编程与开发过程中，准确获取当前设备支持的音频采样率是一项基础且至关重要的任务。幸运的是，借助HTML5 AudioContext API，这一操作变得异常简单。AudioContext对象的sampleRate属性正是实现这一功能的关键，它直接返回一个以赫兹（Hz）为单位的数值，代表当前音频上下文所使用的采样频率。该数值由浏览器在初始化AudioContext时，依据您的设备硬件能力与操作系统音频设置自动设定。最大的便利在于，您无需执行额外的函数调用，也不必等待任何异步流程，创建实例后即可立即读取。

直接访问 sampleRate 属性值

具体如何操作？方法非常直观。当您成功创建AudioContext实例后，直接访问其sampleRate属性即可。以下是一段标准示例代码：

const audioContext = new (window.AudioContext || window.webkitAudioContext)();
console.log(audioContext.sampleRate); // 典型输出值：44100、48000 或 96000

该属性为只读属性，意味着在AudioContext的整个生命周期内，其值一经确定便不会发生变化。然而，不同设备、浏览器或系统环境可能返回不同的采样率数值。常见的采样率包括44100 Hz（即CD音质标准）、48000 Hz（广泛用于USB声卡及数字视频设备），在一些专业或高性能音频设备上，您还可能遇到96000 Hz甚至更高的采样率。

确保音频上下文已启动

这里有一个重要的技术细节需要注意。在部分浏览器，尤其是Chrome及基于Chromium内核的浏览器中，新创建的AudioContext默认处于“暂停”状态。虽然在此状态下，您通常仍能成功读取sampleRate的值，但为了确保音频上下文已完全激活并成功关联至系统底层音频驱动，一个更为稳健的做法是：在页面获得用户交互（例如点击按钮）后，再调用上下文的resume()方法。

立即学习“前端免费学习笔记（深入）”；

• 尽管在上下文未启动时读取sampleRate多数情况下有效，但某些旧版Safari浏览器可能存在初始化延迟的问题。
• 在调用audioContext.resume()激活上下文后再次读取采样率，可以确保其已与系统音频设备正确关联。

避免为获取新采样率而重复创建上下文

需要明确的是，sampleRate在单个AudioContext实例的存续期间是固定不变的，它不会跟随系统声音设置的实时更改而自动更新。若您希望获取一个“更新后”的采样率，唯一途径是重新创建一个AudioContext实例。但请注意，这种做法需谨慎对待：

• 频繁重建AudioContext是不可取的，它会中断所有正在进行的音频播放，并重置所有内部音频节点状态。
• 即便您在系统层面（例如macOS的音频MIDI设置）更改了默认输出设备的采样率，此类变更通常也需要刷新整个网页，才能在新的AudioContext实例中生效。
• 因此，一个推荐的最佳实践是：在应用首次加载时获取并缓存采样率数值，随后在整个应用生命周期内复用此值，例如用于配置WebAssembly音频解码器参数，或实现自定义的音频重采样算法。

浏览器兼容性与稳健性处理

为确保代码在Safari等仍依赖前缀的旧版本浏览器中稳定运行，建议采用以下标准的构造函数检测与实例化模式：

const AudioContext = window.AudioContext || window.webkitAudioContext;
const ctx = new AudioContext();
const rate = ctx.sampleRate; // 此时可安全读取设备音频采样率

关于错误处理，有一个令人放心的结论：只要AudioContext对象能够被成功实例化，那么它的sampleRate属性就必定存在，且一定是一个有效的数字值。因此，您几乎无需为此编写额外的容错或异常捕获代码。