SpeechSynthesis: getVoices() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年9月以降、すべてのブラウザーで利用可能です。
getVoices() は SpeechSynthesis インターフェイスのメソッドで、現在の端末で利用できるすべての音声を表す SpeechSynthesisVoice オブジェクトのリストを返します。
構文
js
getVoices()
引数
なし。
返値
SpeechSynthesisVoice オブジェクトのリスト（配列）です。
例
JavaScript
js
function populateVoiceList() {
if (typeof speechSynthesis === "undefined") {
return;
}
const voices = speechSynthesis.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);
document.getElementById("voiceSelect").appendChild(option);
}
}
populateVoiceList();
if (
typeof speechSynthesis !== "undefined" &&
speechSynthesis.onvoiceschanged !== undefined
) {
speechSynthesis.onvoiceschanged = populateVoiceList;
}
HTML
html
<select id="voiceSelect"></select>
仕様書
| 仕様書 |
|---|
| Web Speech API # dom-speechsynthesis-getvoices |