SpeechSynthesis

Experimental: Esta é uma tecnologia experimental (en-US)
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.

A interface SpeechSynthesis da Web Speech API (en-US) é a interface controladora para o serviço de fala; este pode ser usado para obter informações sobre as vozes sintetizadas disponíveis no dispositivo, reproduzir e pausar uma elocução, além de outros comandos.

Propriedades

SpeechSynthesis também herda propriedades da sua interface pai, EventTarget.

SpeechSynthesis.paused (en-US) Somente leitura

Um Boolean (en-US) que retorna true se o objeto SpeechSynthesis está em estado de pausa.

SpeechSynthesis.pending (en-US) Somente leitura

Um Boolean (en-US) que retorna true se a fila de elocuções contém falas que ainda não foram reproduzidas.

SpeechSynthesis.speaking (en-US) Somente leitura

Um Boolean (en-US) que retorna true se uma elocução está sendo reproduzida atualmente — mesmo que SpeechSynthesis esteja em estado de pausa.

Tratamento de eventos

SpeechSynthesis.onvoiceschanged (en-US)

Disparado quando a lista de objetos SpeechSynthesisVoice (en-US) que pode ser retornada pelo método SpeechSynthesis.getVoices() (en-US) mudou.

Métodos

SpeechSynthesis também herda métodos da sua interface pai, EventTarget.

SpeechSynthesis.cancel() (en-US)

Remove todas as elocuções da fila para reprodução.

SpeechSynthesis.getVoices() (en-US)

Retorna uma lista de objetos SpeechSynthesisVoice (en-US) representando todas as vozes disponíveis no dispositivo atuall

SpeechSynthesis.pause() (en-US)

Deixa o objeto SpeechSynthesis em estado de pausa.

SpeechSynthesis.resume() (en-US)

Retira o estado de pausa do objeto SpeechSynthesis: retoma a reprodução se ele estiver pausado.

SpeechSynthesis.speak() (en-US)

Adiciona uma utterance (en-US) à fila de reprodução; ela será reproduzida assim que todas as elocuções enfileiradas anteriormente tenham sido reproduzidas.

Exemplos

Na nossa demonstração básica Speech synthesiser demo, nós primeiro pegamos uma referência para o controlador SpeechSynthesis usando window.speechSynthesis. Após definir algumas variáveis necessárias, nós obtemos uma lista de vozes disponíveis usando o método SpeechSynthesis.getVoices() (en-US) usando-as para popular um menu de seleção de forma que o usuário possa escolher a voz que desejar.

Dentro do tratamento inputForm.onsubmit, nós impedimos a submissão do formulário com preventDefault(), instanciamos uma SpeechSynthesisUtterance (en-US) contendo o texto presente no <input>, atribuímos a voz da elocução para a voz selecionada no elemento <select>, e iniciamos a reprodução da elocução através do método SpeechSynthesis.speak() (en-US).

js
var synth = window.speechSynthesis;

var inputForm = document.querySelector("form");
var inputTxt = document.querySelector(".txt");
var voiceSelect = document.querySelector("select");

var pitch = document.querySelector("#pitch");
var pitchValue = document.querySelector(".pitch-value");
var rate = document.querySelector("#rate");
var rateValue = document.querySelector(".rate-value");

var voices = [];

function populateVoiceList() {
  voices = synth.getVoices();

  for (i = 0; i < voices.length; i++) {
    var option = document.createElement("option");
    option.textContent = voices[i].name + " (" + voices[i].lang + ")";

    if (voices[i].default) {
      option.textContent += " -- DEFAULT";
    }

    option.setAttribute("data-lang", voices[i].lang);
    option.setAttribute("data-name", voices[i].name);
    voiceSelect.appendChild(option);
  }
}

populateVoiceList();
if (speechSynthesis.onvoiceschanged !== undefined) {
  speechSynthesis.onvoiceschanged = populateVoiceList;
}

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];
    }
  }
  utterThis.pitch = pitch.value;
  utterThis.rate = rate.value;
  synth.speak(utterThis);

  inputTxt.blur();
};

Especificações

Specification
Web Speech API
# tts-section

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também