0

0

SpeechSynthesis.getVoices() 返回空数组的解决方案

聖光之護

聖光之護

发布时间:2026-01-26 09:10:02

|

158人浏览过

|

来源于php中文网

原创

SpeechSynthesis.getVoices() 返回空数组的解决方案

speechsynthesis api 的 `getvoices()` 方法在页面加载初期常返回空数组,因其语音列表异步加载;需监听 `voiceschanged` 事件确保语音就绪后再获取并设置 voice。

SpeechSynthesis.getVoices() 并非同步阻塞方法——它立即返回当前已加载的语音列表,而浏览器语音引擎(如 Chrome 的本地 TTS 或系统语音服务)通常在页面加载后异步初始化并注入可用语音。因此,若在脚本执行早期(例如

✅ 正确做法是:始终通过 speechSynthesis.onvoiceschanged 事件(或 addEventListener("voiceschanged", ...))监听语音就绪时机。该事件会在语音列表首次加载完成或后续动态更新(如系统新增语音)时触发,是唯一可靠的同步点。

以下是推荐的健壮实现方式:

云点滴客户关系管理CRM OA系统
云点滴客户关系管理CRM OA系统

云点滴客户解决方案是针对中小企业量身制定的具有简单易用、功能强大、永久免费使用、终身升级维护的智能化客户解决方案。依托功能强大、安全稳定的阿里云平 台,性价比高、扩展性好、安全性高、稳定性好。高内聚低耦合的模块化设计,使得每个模块最大限度的满足需求,相关模块的组合能满足用户的一系列要求。简单 易用的云备份使得用户随时随地简单、安全、可靠的备份客户信息。功能强大的报表统计使得用户大数据分析变的简单,

下载
function speakWithCustomVoice() {
  const msg = new SpeechSynthesisUtterance("Hello World!");

  // 确保语音已加载
  function setAndSpeak() {
    const voices = speechSynthesis.getVoices();

    // 安全检查:避免越界访问
    if (voices.length > 2) {
      msg.voice = voices[2]; // 例如选择第3个语音(如 Microsoft Linda)
      speechSynthesis.speak(msg);
    } else {
      console.warn("未检测到足够多的语音,使用默认语音播放");
      speechSynthesis.speak(msg);
    }
  }

  // 首次监听 voiceschanged
  speechSynthesis.addEventListener("voiceschanged", setAndSpeak, { once: true });

  // 兜底处理:若事件未触发(极罕见),延迟重试(可选)
  setTimeout(() => {
    if (speechSynthesis.getVoices().length === 0) {
      console.warn("警告:voiceschanged 事件未触发,尝试手动重试");
      setAndSpeak();
    }
  }, 1000);
}

speakWithCustomVoice();

⚠️ 注意事项:

  • 不要依赖 setTimeout 替代事件监听:setTimeout(…, 100) 是不可靠的“魔法数字”,不同设备/网络下语音加载时间差异大;
  • once: true 选项防止重复绑定:避免多次触发导致重复播报;
  • 始终校验 voices.length:索引访问前必须判断数组长度,否则可能报 Cannot set property 'voice' of undefined;
  • 跨浏览器兼容性:Firefox、Chrome、Edge 均支持 voiceschanged,但 Safari(iOS/macOS)对 Web Speech API 支持有限(仅部分版本支持且需用户授权),生产环境建议添加特性检测与降级提示。

总结:getVoices() 的“空数组陷阱”本质是异步资源加载时序问题。拥抱事件驱动模型,以 voiceschanged 为守门人,即可稳定、可维护地控制语音合成行为。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

823

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

741

2023.11.06

html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

620

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

661

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

474

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

245

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2904

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

508

2023.08.11

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

70

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

AngularJS教程
AngularJS教程

共24课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 23.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号