一、前言
前一段时间在项目中需要用到播报文字语音。找到了 HTML 5 有这样的功能。
现在有时间进行总结下。
二、SpeechSynthesis
SpeechSynthesis 接口是语音服务的控制接口。它可以用于获取设备上关于可用的合成声音的信息,
开始、暂停语音,或者别的命令。(MDN)
SpeechSynthesis 是 window 上面的属性,可以直接调用。
属性:
下面的都是只读属性
paused:是否处于暂停状态,返回 Boolean 值
pending:语音播报队列中是否有需要说的语音,返回 Boolean 值
speaking:是否正在进行语音播报(包括暂停状态),返回 Boolean 值
事件:
onvoiceschanged:当 getVoices 返回的 voices 列表改变时触发
方法:
cancel:移除所有语音播报队列中的语音
getVoices:返回当前设备可用的声音列表
pause:暂停语音播报
resume:把对象设置为非暂停状态,如果是暂停就继续
speak:添加一个 utterance 到语音播报队列,会在其他语音播报后播报
三、SpeecheSynthesisUtterance
SpeecheSynthesisUtterance 是语音请求的一个类。需要实例化才可以使用。
它包含语音要阅读的内容以及如何阅读(例如语言、音调、音量等)
属性:
lang:读取或设置当前要阅读的语音
pitch:读取或设置阅读的音调
rate:读取或设置阅读的语速
text:读取或设置阅读的内容
voice:读取或设置阅读的声音(不同的浏览器有不同内置的人声)
volume:读取或设置阅读的音量
事件:
boundary:当阅读到单词或句子的边界时触发
end:当阅读结束时触发
error:当阅读报错时触发
mark:当阅读到 SSML 标记时触发
pause:当阅读暂停时触发
resume:当阅读设置为非暂停时触发
start:开始阅读时触发
上面的事件都是用 addEventListenter 绑定事件,同时也可以用对应的 onEventname 绑定事件
四、示例
上面两个 API 可以满足基本的语音播报需要了,下面就是一个示例
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>语音合成</title> <style> /* input{ width: 500px; height: 200px; } */ </style> </head> <body> <div> <h3> <a href="https://blog.csdn.net/yb305/article/details/111219007" target="_blank"> 语音合成使用 文字语音播报 </a> </h3> <h3> <a href="https://www.jianshu.com/p/92dec635f6c5" target="_blank"> HTML5语音合成Speech Synthesis API简介 </a> </h3> <textarea rows="5" cols="100" id="input" placeholder="请输入内容"></textarea> <div> <p> <label>语言:</label> <select id="lange"> <option value="zh-cn" selected>中文</option> <option value="en-US">英文</option> </select> </p> <p> <label>音量:</label><input type="range" min="0" max="1" step="0.1" id="volume" /> </p> <p> <label>音速:</label><input type="range" min="0" max="10" step="0.1" id="rate" /> </p> <p> <label>音色:</label><input type="range" min="0" max="2" step="0.1" id="pitch" /> </p> </div> <div> <button type="button" id="submit">播报</button> <button type="button" id="suspend">暂停</button> <button type="button" id="recovery">恢复</button> <button type="button" id="stop">停止</button> </div> </div> <script> // 1.获取input框输入的内容 function getValue() { //定义全局对象 const obj = { text: "", lange: "zh-cn", volume: 1, rate: 1, pitch: 1, }; //点击“播报”按钮 const Dom = document.getElementById("submit"); Dom.onclick = function () { const value = document.getElementById("input").value; if (!value) return; console.log("点击获取内容1", value); obj.text = value; speeck(obj); }; //按下回车键按钮 window.onkeyup = function (e) { // console.log("e",e); const value = document.getElementById("input").value; if (e.keyCode !== 13 || !value) return; console.log("回车获取内容2", value); obj.text = value; speeck(obj); }; //暂停播报 const suspend = document.getElementById("suspend"); suspend.onclick = function () { window.plays.pause(); //暂停 }; //恢复播报 const recovery = document.getElementById("recovery"); recovery.onclick = function () { window.plays.resume(); //恢复 }; //停止播报 const stop = document.getElementById("stop"); stop.onclick = function () { window.plays.cancel(); //停止 }; //选择语言 const lange = document.getElementById("lange"); lange.onchange = function (v) { console.log("选择语言", v); console.log("选择语言-2", v.target.value); obj.lange = v.target.value; speeck(obj); }; //选择音量 const volume = document.getElementById("volume"); volume.onchange = function (v) { console.log("选择音量", v.target.value); obj.volume = v.target.value; speeck(obj); }; //选择音速 const rate = document.getElementById("rate"); rate.onchange = function (v) { console.log("选择音速", v.target.value); obj.rate = v.target.value; speeck(obj); }; //选择音色 const pitch = document.getElementById("pitch"); pitch.onclick = function (v) { console.log("选择音色", v.target.value); obj.pitch = v.target.value; speeck(obj); }; } //调用执行 getValue(); //2.语音播报 function speeck(data) { console.log("播报时", data); //SpeechSynthesisUtterance对象,主要用来构建语音合成实例 window.voice = new window.SpeechSynthesisUtterance(); // 对象合成方法 Object.assign(window.voice, data) //speechSynthesis对象,主要作用是触发行为,例如读,停,还原 window.plays = window.speechSynthesis; window.plays.speak(window.voice); } </script> </body> </html>
复制