在此页

• 构造函数
• 特性
• 事件
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

SpeechSynthesisUtterance 接口在 Web 语音 API represents a speech request. It contains the content the speech service should read and information about how to read it (e.g. language, pitch and volume.)

构造函数

SpeechSynthesisUtterance.SpeechSynthesisUtterance()

返回新的 SpeechSynthesisUtterance 对象实例。

特性

SpeechSynthesisUtterance also inherits properties from its parent interface, EventTarget .

SpeechSynthesisUtterance.lang

Gets and sets the language of the utterance.

SpeechSynthesisUtterance.pitch

Gets and sets the pitch at which the utterance will be spoken at.

SpeechSynthesisUtterance.rate

Gets and sets the speed at which the utterance will be spoken at.

SpeechSynthesisUtterance.text

Gets and sets the text that will be synthesised when the utterance is spoken.

SpeechSynthesisUtterance.voice

Gets and sets the voice that will be used to speak the utterance.

SpeechSynthesisUtterance.volume

Gets and sets the volume that the utterance will be spoken at.

事件

监听这些事件使用 addEventListener() 或通过把事件监听器赋值给 on eventname 特性为此接口。

boundary

Fired when the spoken utterance reaches a word or sentence boundary.
也可用凭借 onboundary 特性。

end

Fired when the utterance has finished being spoken.
也可用凭借 onend 特性。

error

Fired when an error occurs that prevents the utterance from being succesfully spoken.
也可用凭借 onerror property

mark

Fired when the spoken utterance reaches a named SSML "mark" tag.
也可用凭借 onmark 特性。

pause

Fired when the utterance is paused part way through.
也可用凭借 onpause 特性。

resume

Fired when a paused utterance is resumed.
也可用凭借 onresume 特性。

start

Fired when the utterance has begun to be spoken.
也可用凭借 onstart 特性。

范例

In our basic Speech synthesiser demo ( source ), we first grab a reference to the SpeechSynthesis controller using window.speechSynthesis . After defining some necessary variables, we retrieve a list of the voices available using SpeechSynthesis.getVoices() and populate a select menu with them so the user can choose what voice they want.

Inside the inputForm.onsubmit handler, we stop the form submitting with preventDefault() ，使用 构造函数 to create a new utterance instance containing the text from the text <input> , set the utterance's voice to the voice selected in the <select> element, and start the utterance speaking via the SpeechSynthesis.speak() 方法。

var synth = window.speechSynthesis;
var voices = synth.getVoices();
var inputForm = document.querySelector('form');
var inputTxt = document.querySelector('input');
var voiceSelect = document.querySelector('select');
for(var i = 0; i < voices.length; i++) {
  var option = document.createElement('option');
  option.textContent = voices[i].name + ' (' + voices[i].lang + ')';
  option.value = i;
  voiceSelect.appendChild(option);
}
inputForm.onsubmit = function(event) {
  event.preventDefault();
  var utterThis = new SpeechSynthesisUtterance(inputTxt.value);
  utterThis.voice = voices[voiceSelect.value];
  synth.speak(utterThis);
  inputTxt.blur();
}
					

规范

规范	状态	注释
Web 语音 API The definition of 'SpeechSynthesisUtterance' in that specification.	草案

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
SpeechSynthesisUtterance	Chrome 33	Edge ≤18	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
SpeechSynthesisUtterance() 构造函数	Chrome 33	Edge ≤18	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
boundary event	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
end event	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
error event	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
lang	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
mark event	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
onboundary	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
onend	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
onerror	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
onmark	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
onpause	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
onresume	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
onstart	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
pause event	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
pitch	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
rate	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
resume event	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
start event	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
text	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
voice	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0
volume	Chrome 33	Edge 14	Firefox 49	IE 不支持 No	Opera 21	Safari 7	WebView Android 不支持 No	Chrome Android 33	Firefox Android 62	Opera Android 不支持 No	Safari iOS 7	Samsung Internet Android 3.0

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

用户必须明确启用此特征。

用户必须明确启用此特征。

另请参阅

• Web 语音 API

元数据

• 最后修改： Jun 24, 2020

相关话题

1. SpeechSynthesisUtterance
2. 构造函数

   1. SpeechSynthesisUtterance()
3. 特性

   1. lang
   2. onboundary
   3. onend
   4. onerror
   5. onmark
   6. onpause
   7. onresume
   8. onstart
   9. pitch
   10. rate
   11. text
   12. voice
   13. volume
4. 事件

   1. boundary
   2. end
   3. error
   4. mark
   5. pause
   6. resume
   7. start
5. 继承：

   1. EventTarget
6. Related pages for Web Speech API

   1. SpeechGrammar
   2. SpeechGrammarList
   3. SpeechRecognition
   4. SpeechRecognitionAlternative
   5. SpeechRecognitionError
   6. SpeechRecognitionEvent
   7. SpeechRecognitionResult
   8. SpeechRecognitionResultList
   9. SpeechSynthesis
   10. SpeechSynthesisErrorEvent
   11. SpeechSynthesisEvent
   12. SpeechSynthesisVoice