必须用 Web Audio API 的 AnalyserNode 接入音频流才能获取频谱数据，因为 <audio> 元素仅提供时域控制属性，不支持频域分析；直接监听 timeupdate 或解析 buffer 均无效，且 AnalyserNode 必须通过 createMediaElementSource 正确连接并连至 destination 才能工作。
不能直接从 <audio> 标签拿到频谱数据，必须用 Web Audio API 的 AnalyserNode 接入音频流后读取 —— 这是唯一可行路径，其他任何“监听 timeupdate”或“解析 audio.buffer”的思路都会失败。
为什么 <audio> 本身不提供频谱接口
<audio> 元素只暴露时域控制属性（如 currentTime、volume），没有任何频域分析能力。浏览器不会在后台为你做 FFT，也不会把频谱数据挂到 DOM 属性上。试图用 audio.addEventListener('timeupdate', ...) 拿频点？返回值永远是 undefined 或报错。
- 常见错误现象：
analyser.getByteFrequencyData(freqData)返回全 0 数组 → 实际上音频流根本没连进AnalyserNode - 错误写法：
const ctx = new AudioContext(); const analyser = ctx.createAnalyser();之后就直接调用读取 → 缺少createMediaElementSource(audioEl)和.connect(analyser)这两步，节点是悬空的 - iOS Safari 上完全无反应 →
AudioContext没在用户手势（如click）回调中启动，被系统静音挂起
正确连接 <audio> 到 AnalyserNode
必须显式创建媒体源节点，并确保信号流经 AnalyserNode，否则它就是个摆设。
- 等
audio元素触发loadeddata事件后再创建源节点，避免InvalidStateError - 用
context.createMediaElementSource(audioEl)绑定，不是直接操作audioEl.src - 连接顺序必须完整：源 →
analyser→context.destination（即使你只想分析、不播放，也得连到 destination，否则部分浏览器会拒绝更新数据） - 记得设置
analyser.fftSize = 2048（必须是 2 的幂），否则用默认值可能在旧版 Chrome 中只有 1024 点，或在某些移动端返回异常长度
用 getByteFrequencyData 读取并绘制到 <canvas>
数据读取和绘制必须绑定 requestAnimationFrame，且缓冲区要复用，否则掉帧、卡顿、内存抖动全来。
立即学习“前端免费学习笔记（深入）”；
- 预分配一次
Uint8Array：const freqData = new Uint8Array(analyser.frequencyBinCount)，后续所有帧都传这个实例，别每次新建 - 每帧调用
analyser.getByteFrequencyData(freqData)填充数据，值域固定为 0–255（对数压缩后幅度，不是线性能量） - 柱子宽度不能硬写：
barWidth = canvas.width / freqData.length，否则换分辨率或缩放就错位 - 清画布别用
ctx.clearRect(0, 0, canvas.width, canvas.height)，改用ctx.fillStyle = '#000'; ctx.fillRect(0, 0, canvas.width, canvas.height)，部分浏览器更快 - 高频绘制下，
fillRect比beginPath + lineTo + stroke快 5–10 倍，优先选前者画柱状图
移动端和低代码平台的硬限制怎么绕
iOS Safari 要求用户点击后才允许启用音频上下文，Jimdo/Webflow 类平台会过滤 <script> 或禁用 AudioContext，这些不是 bug，是策略限制。
- 不能靠
autoplay+muted触发：iOS 即使静音，AnalyserNode仍不工作 - 可靠做法：放一个「开始可视化」按钮，
click回调里初始化AudioContext、连接节点、调用audio.play()（哪怕只是试播 1ms） - 在 Jimdo 等平台，只能用
<iframe>嵌入外部 HTML 文件，把完整逻辑（含AudioContext初始化、analyser连接、canvas绘制）封装进去
最容易被忽略的是：analyser.frequencyBinCount 是动态计算值（fftSize / 2），不是固定常量；而低频段（前几十个索引）对应人耳最敏感的鼓点和人声，高频段（后几百个）实际分辨率极低——如果只按索引线性映射到 canvas 宽度，视觉上会严重失衡。真正稳定的频谱图，得加对数分组或指数映射，而不是直接拉条形图。
