SpeechSynthesisUtterance
Experimental: Esta é uma tecnologia experimental (en-US)
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.
The SpeechSynthesisUtterance
interface of the Web Speech API (en-US) 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.)
Constructor
SpeechSynthesisUtterance.SpeechSynthesisUtterance()
(en-US)-
Returns a new
SpeechSynthesisUtterance
object instance.
Properties
SpeechSynthesisUtterance
also inherits properties from its parent interface, EventTarget
.
SpeechSynthesisUtterance.lang
(en-US)-
Gets and sets the language of the utterance.
SpeechSynthesisUtterance.pitch
(en-US)-
Gets and sets the pitch at which the utterance will be spoken at.
SpeechSynthesisUtterance.rate
(en-US)-
Gets and sets the speed at which the utterance will be spoken at.
SpeechSynthesisUtterance.text
(en-US)-
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
(en-US)-
Gets and sets the volume that the utterance will be spoken at.
Event handlers
SpeechSynthesisUtterance.onboundary
(en-US)-
Fired when the spoken utterance reaches a word or sentence boundary.
SpeechSynthesisUtterance.onend
(en-US)-
Fired when the utterance has finished being spoken.
SpeechSynthesisUtterance.onerror
(en-US)-
Fired when an error occurs that prevents the utterance from being succesfully spoken.
SpeechSynthesisUtterance.onmark
(en-US)-
Fired when the spoken utterance reaches a named SSML "mark" tag.
SpeechSynthesisUtterance.onpause
(en-US)-
Fired when the utterance is paused part way through.
SpeechSynthesisUtterance.onresume
(en-US)-
Fired when a paused utterance is resumed.
SpeechSynthesisUtterance.onstart
(en-US)-
Fired when the utterance has begun to be spoken.
Examples
In our basic Speech synthesiser demo, 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()
(en-US) 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(), use the constructor
(en-US) 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()
(en-US) method.
var synth = window.speechSynthesis;
var inputForm = document.querySelector('form');
var inputTxt = document.querySelector('input');
var voiceSelect = document.querySelector('select');
var voices = synth.getVoices();
for(i = 0; i < voices.length ; i++) {
var option = document.createElement('option');
option.textContent = voices[i].name + ' (' + voices[i].lang + ')';
option.setAttribute('data-lang', voices[i].lang);
option.setAttribute('data-name', voices[i].name);
voiceSelect.appendChild(option);
}
inputForm.onsubmit = function(event) {
event.preventDefault();
var utterThis = new SpeechSynthesisUtterance(inputTxt.value);
var selectedOption = voiceSelect.selectedOptions[0].getAttribute('data-name');
for(i = 0; i < voices.length ; i++) {
if(voices[i].name === selectedOption) {
utterThis.voice = voices[i];
}
}
synth.speak(utterThis);
inputTxt.blur();
}
Specifications
Specification | Status | Comment |
---|---|---|
Web Speech API The definition of 'SpeechSynthesisUtterance' in that specification. |
Rascunho |
Compatibilidade com navegadores
BCD tables only load in the browser