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 with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* Web Speech API (en-US)