这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

getVoices() 方法在 SpeechSynthesis interface returns a list of SpeechSynthesisVoice objects representing all the available voices on the current device.

句法

speechSynthesisInstance.getVoices();
					

参数

None.

返回值

A list (array) of SpeechSynthesisVoice 对象。

注意 : The spec wrongly lists this method as returning as a SpeechSynthesisVoiceList object, but this was in fact removed from the spec.

范例

JavaScript

function populateVoiceList() {
  if(typeof speechSynthesis === 'undefined') {
    return;
  }
  var voices = speechSynthesis.getVoices();
  for(var 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);
    document.getElementById("voiceSelect").appendChild(option);
  }
}
populateVoiceList();
if (typeof speechSynthesis !== 'undefined' && speechSynthesis.onvoiceschanged !== undefined) {
  speechSynthesis.onvoiceschanged = populateVoiceList;
}
					

HTML

<select id="voiceSelect"></select>
					

规范

规范 状态 注释
Web 语音 API
The definition of 'getVoices()' in that specification.
草案 初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
getVoices Chrome 33 Edge 14 Firefox 49 IE 不支持 No Opera 21 Safari 7 WebView Android 4.4.3 Chrome Android 33 Firefox Android 62 Opera Android 不支持 No Safari iOS 7 Samsung Internet Android 3.0

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

用户必须明确启用此特征。

用户必须明确启用此特征。

另请参阅

元数据

  • 最后修改: