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

SpeechSynthesisVoice 接口在 Web 语音 API represents a voice that the system supports. Every SpeechSynthesisVoice has its own relative speech service including information about language, name and URI.

特性

SpeechSynthesisVoice.default 只读
布尔 indicating whether the voice is the default voice for the current app language ( true ), or not ( false )。
SpeechSynthesisVoice.lang 只读

Returns a BCP 47 language tag indicating the language of the voice.

SpeechSynthesisVoice.localService 只读
布尔 indicating whether the voice is supplied by a local speech synthesizer service ( true ), or a remote speech synthesizer service ( false )。
SpeechSynthesisVoice.name 只读

Returns a human-readable name that represents the voice.

SpeechSynthesisVoice.voiceURI 只读

Returns the type of URI and location of the speech synthesis service for this voice.

范例

The following snippet is excerpted from our Speech synthesiser demo .

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);
  utterThis.onpause = function(event) {
    var char = event.utterance.text.charAt(event.charIndex);
    console.log('Speech paused at character ' + event.charIndex + ' of "' +
    event.utterance.text + '", which is "' + char + '".');
  }
  inputTxt.blur();
}
					

规范

规范 状态 注释
Web 语音 API
The definition of 'SpeechSynthesisVoice' 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
SpeechSynthesisVoice Chrome 33 Edge ≤18 Firefox 49 IE No Opera 21 Safari 7 WebView Android 4.4.3 Chrome Android 33 Firefox Android 62
62
不支持 61 — 62 Disabled
Disabled ). To change preferences in Firefox, visit
Opera Android No Safari iOS 7 Samsung Internet Android 3.0
default Chrome 33 Edge 14 Firefox 49 IE No Opera 21 Safari 7 WebView Android 4.4.3 Chrome Android 33 Firefox Android 62
62
不支持 61 — 62 Disabled
Disabled ). To change preferences in Firefox, visit
Opera Android No Safari iOS 7 Samsung Internet Android 3.0
lang Chrome 33 Edge 14 Firefox 49 IE No Opera 21 Safari 7 WebView Android 4.4.3 Chrome Android 33 Firefox Android 62
62
不支持 61 — 62 Disabled
Disabled ). To change preferences in Firefox, visit
Opera Android No Safari iOS 7 Samsung Internet Android 3.0
localService Chrome 33 Edge 14 Firefox 49 IE No Opera 21 Safari 7 WebView Android 4.4.3 Chrome Android 33 Firefox Android 62
62
不支持 61 — 62 Disabled
Disabled ). To change preferences in Firefox, visit
Opera Android No Safari iOS 7 Samsung Internet Android 3.0
名称 Chrome 33 Edge 14 Firefox 49 IE No Opera 21 Safari 7 WebView Android 4.4.3 Chrome Android 33 Firefox Android 62
62
不支持 61 — 62 Disabled
Disabled ). To change preferences in Firefox, visit
Opera Android No Safari iOS 7 Samsung Internet Android 3.0
voiceURI Chrome 33 Edge 14 Firefox 49 IE No Opera 21 Safari 7 WebView Android 4.4.3 Chrome Android 33 Firefox Android 62
62
不支持 61 — 62 Disabled
Disabled ). To change preferences in Firefox, visit
Opera Android No Safari iOS 7 Samsung Internet Android 3.0

图例

完整支持

完整支持

不支持

不支持

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

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

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

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

另请参阅

元数据

  • 最后修改:
  1. SpeechSynthesisVoice
  2. 特性
    1. default
    2. lang
    3. localService
    4. 名称
    5. voiceURI
  3. Related pages for Web Speech API
    1. SpeechGrammar
    2. SpeechGrammarList
    3. SpeechRecognition
    4. SpeechRecognitionAlternative
    5. SpeechRecognitionError
    6. SpeechRecognitionEvent
    7. SpeechRecognitionResult
    8. SpeechRecognitionResultList
    9. SpeechSynthesis
    10. SpeechSynthesisErrorEvent
    11. SpeechSynthesisEvent
    12. SpeechSynthesisUtterance

版权所有  © 2014-2026 乐数软件    

工业和信息化部: 粤ICP备14079481号-1