speechrecognition api 无法实现波形动画,因其不提供音频流数据,需配合 web audio api 手动分析;ios safari 和 android webview 不支持该 api,必须用 mediarecorder + 后端 asr 或模拟波形替代。

直接用 SpeechRecognition API 实现不了“AI语音输入界面”里的波形动画——它本身不提供音频流数据,只返回识别后的文本。所谓“波形动效”,必须额外接入 Web Audio API 才能拿到实时麦克风音量或频谱,再手动绘制。而且这个组合在 iOS Safari 和 Android WebView 中根本不可用。
为什么 SpeechRecognition 没有波形数据
SpeechRecognition 是一个纯识别接口,设计目标就是“听清后吐文字”,浏览器刻意屏蔽了原始音频流访问权限。它连 onaudioprocess 这类回调都不暴露,更别说 analyserNode 或 getByteFrequencyData()。你看到的那些带跳动波形的“AI语音输入框”,背后一定是两套并行逻辑:一套走 SpeechRecognition 做识别,另一套用 MediaRecorder + Web Audio API 做可视化。
- 试图从
onresult事件里提取音量或频率 → 不可能,event 里只有results、resultIndex - 给
recognition实例加onaudioprocess监听 → 无效,该对象根本不继承AudioNode - 以为
interimResults = true就能触发波形更新 → 它只影响文本输出时机,和音频采集无关
怎么让输入框真正显示语音波形
必须绕过 SpeechRecognition 的黑盒限制,自己接管麦克风流,再分路处理:一路送识别,一路送分析。关键步骤是先用 navigator.mediaDevices.getUserMedia({ audio: true }) 获取 MediaStream,再用 AudioContext 创建分析节点。
- 不能直接用
recognition.start()后再尝试分析 —— 此时流已被识别引擎独占,无法二次读取 - 必须在调用
getUserMedia后立即创建AudioContext和AnalyserNode,否则 iOS 会静默拒绝音频上下文启动 - 波形绘制建议用
getByteTimeDomainData()(时域)而非getByteFrequencyData()(频域),前者对人眼节奏反馈更自然 - 记得在
recognition.onend里手动stop()录音流,否则麦克风图标常驻,用户感知异常
简短示意:
const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
const audioContext = new (window.AudioContext || window.webkitAudioContext)();
const analyser = audioContext.createAnalyser();
analyser.fftSize = 256;
const source = audioContext.createMediaStreamSource(stream);
source.connect(analyser);
// 然后 requestAnimationFrame 循环读取 analyser.getFloatTimeDomainData() 绘制 canvas
移动端和 Safari 的现实约束
iOS Safari 完全不支持 SpeechRecognition,Android WebView 默认禁用该 API,且多数定制内核(如微信 X5)直接移除了 Web Speech 实现。这意味着你写的波形动画代码,在 iPhone 上可能连麦克风请求弹窗都不会出现。
- 检测可用性不能只看
window.SpeechRecognition,还要结合typeof MediaRecorder !== 'undefined'和audioContext.state === 'running' - 不要在页面加载完成就自动启动录音 —— iOS 要求明确用户手势(如 click/tap)触发
getUserMedia,否则静默失败 - 如果目标用户大量使用微信或钉钉内嵌页,基本可放弃原生方案,改用后端 ASR + 前端上传录音文件的方式
替代路径:轻量级可行方案
真要快速上线一个“看起来像 AI 语音输入”的界面,又不想被兼容性拖垮,可以接受折中:用 MediaRecorder 录一段音频(比如 5 秒),上传到后端 ASR 服务(如阿里云智能语音交互、腾讯云语音识别),再把结果填回输入框。波形动画只模拟节奏,不依赖真实音频流 —— 用 CSS 动画或 Canvas 随机生成起伏,配合按钮状态切换,体验差距不大,但 100% 可控。
- 避免在前端硬扛模型推理,
WebAssembly加载 Whisper.cpp 仍受限于 iOS 内存策略和 Safari 的 WASM 限制 - 若必须前端识别,优先考虑
Whisper.cpp + Web Worker方案,但需接受首次加载慢、低端机卡顿、无实时波形等事实 - 所有方案都绕不开 HTTPS —— HTTP 页面连
getUserMedia都会被 Chrome 拦截,localhost 是唯一例外
波形不是装饰,它是用户对“系统正在听”的唯一视觉锚点;但它的实现成本远高于多数人预估,尤其当你要覆盖微信、钉钉、iOS 这些主力场景时。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











