SpeechSynthesisUtterance: voice-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.
Die voice-Eigenschaft der SpeechSynthesisUtterance-Schnittstelle ruft die Stimme ab, die zum Sprechen der Äußerung verwendet wird, und legt sie fest.
Diese sollte auf eines der SpeechSynthesisVoice-Objekte gesetzt werden, die von SpeechSynthesis.getVoices() zurückgegeben werden.
Wenn sie nicht festgelegt wird, wenn die Äußerung gesprochen wird, wird die am besten geeignete Standardstimme für die Einstellung der lang-Eigenschaft der Äußerung verwendet.
Wert
Ein SpeechSynthesisVoice-Objekt.
Beispiele
js
const synth = window.speechSynthesis;
const inputForm = document.querySelector("form");
const inputTxt = document.querySelector("input");
const voiceSelect = document.querySelector("select");
const voices = synth.getVoices();
// …
inputForm.onsubmit = (event) => {
event.preventDefault();
const utterThis = new SpeechSynthesisUtterance(inputTxt.value);
const selectedOption =
voiceSelect.selectedOptions[0].getAttribute("data-name");
for (let i = 0; i < voices.length; i++) {
if (voices[i].name === selectedOption) {
utterThis.voice = voices[i];
}
}
synth.speak(utterThis);
inputTxt.blur();
};
Spezifikationen
| Specification |
|---|
| Web Speech API # dom-speechsynthesisutterance-voice |