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 retornatrue
se o objetoSpeechSynthesis
está em estado de pausa. SpeechSynthesis.pending
(en-US) Somente leitura-
Um
Boolean
(en-US) que retornatrue
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 retornatrue
se uma elocução está sendo reproduzida atualmente — mesmo queSpeechSynthesis
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étodoSpeechSynthesis.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
à 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
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).
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
Especificação | Situação | Comentários |
---|---|---|
Web Speech API The definition of 'SpeechSynthesis' in that specification. |
Rascunho |
Compatibilidade com navegadores
BCD tables only load in the browser