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 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

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar! (en-US)
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 33 49 (49) Não suportado ? 7
Feature Android Chrome Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile
Basic support (Yes) (Yes) Não suportado 2.0 Não suportado Não suportado 7.1

See also