SpeechSynthesisVoice

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

SpeechSynthesisVoice interface of the 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 只读
A Boolean 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 只读
A Boolean 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();
}
					

规范

规范 状态 Comment
Web 语音 API
The definition of 'SpeechSynthesisVoice' in that specification.
草案

浏览器兼容性

更新 GitHub 上的兼容性数据
Desktop Mobile
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 From version 61 until version 62 (exclusive): this feature is behind the media.webspeech.synth.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
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 From version 61 until version 62 (exclusive): this feature is behind the media.webspeech.synth.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
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 From version 61 until version 62 (exclusive): this feature is behind the media.webspeech.synth.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
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 From version 61 until version 62 (exclusive): this feature is behind the media.webspeech.synth.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
Opera Android No Safari iOS 7 Samsung Internet Android 3.0
name
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 From version 61 until version 62 (exclusive): this feature is behind the media.webspeech.synth.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
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 From version 61 until version 62 (exclusive): this feature is behind the media.webspeech.synth.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
Opera Android No Safari iOS 7 Samsung Internet Android 3.0

图例

完整支持
完整支持
不支持
不支持
实验。期望将来行为有所改变。
实验。期望将来行为有所改变。
用户必须明确启用此特征。
用户必须明确启用此特征。

另请参阅