speechsynthesis.speak() 必须在用户手势事件（如click）中调用，否则因用户手势要求不满足而报错；需https、显式设lang、监听voiceschanged再获取语音、每次播放前cancel清理队列。
Web Speech API 的 speechSynthesis 在 HTML 中能直接用，但不点一下按钮就播不出来——这是硬限制，不是 bug。
为什么 speechSynthesis.speak() 一刷新页面就静音
浏览器强制要求首次调用 speechSynthesis.speak() 必须发生在用户真实手势事件里（比如 click、touchend），不能在 window.onload、setTimeout 或 AJAX 回调里直接触发。否则会报错：DOMException: The user gesture requirement is not met。
- HTTPS 是前提：本地
file://协议或 HTTP 页面下，speechSynthesis可能完全不可用或静音 - 必须显式设
lang：哪怕只是utterance.lang = 'zh-CN'，漏掉会导致某些浏览器（如 Safari）跳过播放 - 语音列表异步加载：
speechSynthesis.getVoices()初次调用常返回空数组，得监听voiceschanged事件再取
怎么安全地触发一次语音播报
最简可靠写法是绑定到按钮点击，并在回调里做清理和播放：
const button = document.getElementById('speak-btn');
button.addEventListener('click', () => {
// 清掉之前可能卡住的队列
window.speechSynthesis.cancel();
const utterance = new SpeechSynthesisUtterance('您好，正在播报');
utterance.lang = 'zh-CN';
utterance.rate = 1.0;
utterance.pitch = 1.0;
utterance.volume = 1.0;
// 可选：指定语音（需等 voices 加载完）
speechSynthesis.onvoiceschanged = () => {
const voices = speechSynthesis.getVoices();
const cnVoice = voices.find(v => v.lang === 'zh-CN' && v.localService);
if (cnVoice) utterance.voice = cnVoice;
};
speechSynthesis.speak(utterance);
});
- 每次播前必须
speechSynthesis.cancel()，否则重复点击容易堆叠、抢麦、中断不干净 - 不要在
onvoiceschanged外直接赋值utterance.voice，因为此时getVoices()还没准备好 - 移动端 iOS Safari 对自动播放更敏感，哪怕点了按钮，也建议加个
if ('speechSynthesis' in window)兜底提示
长文本、多段语音怎么不卡顿不丢字
浏览器对单次 SpeechSynthesisUtterance 的文本长度没硬限制，但实际中超过 200 字中文容易断句不准、语调生硬，且无法中途暂停/跳转。
- 分块处理比拼接更稳：按标点或语义切分（如句号、问号后），每块用独立
utterance，间隔 300–500ms 启动 - 监听
onend而非靠setTimeout：避免因语速变化导致错位 - 别用
queue模拟：Web Speech 没内置队列管理，靠speechSynthesis.speak()自动排队，但取消/插入逻辑复杂，不如手动控制 - 注意内存：大量
utterance实例未被 GC 可能拖慢，播完可手动置null或复用对象
真正麻烦的不是写几行代码，而是所有浏览器都认“用户点了一下”这个动作，但这个动作到底发生在哪一层（React 事件？原生 click？iframe 里的 touch？）、是否被封装层吞掉、有没有被防抖节流误杀——这些细节一旦漏查，语音就永远静音。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
