SpeechSynthesisVoice
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2018 browserübergreifend verfügbar.
Das SpeechSynthesisVoice-Interface der Web Speech API repräsentiert eine vom System unterstützte Stimme. Jede SpeechSynthesisVoice hat ihren eigenen Sprachdienst, der Informationen über Sprache, Name und URI enthält.
Instanz-Eigenschaften
SpeechSynthesisVoice.defaultSchreibgeschützt-
Ein boolescher Wert, der angibt, ob die Stimme die Standardstimme für die aktuelle App-Sprache ist (
true) oder nicht (false). SpeechSynthesisVoice.langSchreibgeschützt-
Gibt ein BCP 47-Sprachtag zurück, das die Sprache der Stimme angibt.
SpeechSynthesisVoice.localServiceSchreibgeschützt-
Ein boolescher Wert, der angibt, ob die Stimme von einem lokalen Sprachsynthesedienst (
true) oder einem entfernten Sprachsynthesedienst (false) bereitgestellt wird. SpeechSynthesisVoice.nameSchreibgeschützt-
Gibt einen menschenlesbaren Namen zurück, der die Stimme repräsentiert.
SpeechSynthesisVoice.voiceURISchreibgeschützt-
Gibt den URI-Typ und den Standort des Sprachsynthese-Dienstes für diese Stimme zurück.
Beispiele
Der folgende Ausschnitt ist aus unserem Speech synthesizer demo entnommen.
const synth = window.speechSynthesis;
function populateVoiceList() {
voices = synth.getVoices();
for (const voice of voices) {
const option = document.createElement("option");
option.textContent = `${voice.name} (${voice.lang})`;
if (voice.default) {
option.textContent += " — DEFAULT";
}
option.setAttribute("data-lang", voice.lang);
option.setAttribute("data-name", voice.name);
voiceSelect.appendChild(option);
}
}
populateVoiceList();
if (speechSynthesis.onvoiceschanged !== undefined) {
speechSynthesis.onvoiceschanged = populateVoiceList;
}
inputForm.onsubmit = (event) => {
event.preventDefault();
const utterThis = new SpeechSynthesisUtterance(inputTxt.value);
const selectedOption =
voiceSelect.selectedOptions[0].getAttribute("data-name");
for (const voice of voices) {
if (voice.name === selectedOption) {
utterThis.voice = voice;
}
}
utterThis.pitch = pitch.value;
utterThis.rate = rate.value;
synth.speak(utterThis);
utterThis.onpause = (event) => {
const char = event.utterance.text.charAt(event.charIndex);
console.log(
`Speech paused at character ${event.charIndex} of "${event.utterance.text}", which is "${char}".`,
);
};
inputTxt.blur();
};
Spezifikationen
| Spezifikation |
|---|
| Web Speech API # speechsynthesisvoice |