翻譯不完整。請協助 翻譯此英文文件

 

Web Speech API中的SpeechRecognition介面是一個recognition service的控制器介面。他同時也負責處理由識別服務發出的SpeechRecognitionEvent事件。

建構子

SpeechRecognition.SpeechRecognition()
建立一個新的SpeechRecognition物件

屬性

SpeechRecognition 繼承了父介面 EventTarget 的屬性。

SpeechRecognition.grammars
回傳一組用來表示語法且可以被當前的 SpeechRecognition 解析的 SpeechGrammar 物件
SpeechRecognition.lang
取得和設定當前 SpeechRecognition 使用的語言。若沒有特別指定,預設會使用lang 的設定值,或是使用者裝置設定的語言。
SpeechRecognition.continuous
控制每個 recognition 會傳連續的結果還是只回傳單一結果。預設為回傳單一結果 (false.)
SpeechRecognition.interimResults
控制臨時結果是否回傳。 true 回傳,false 不回傳。臨時結果指的是所有非最終 (Final) 結果的結果。 (例如 : SpeechRecognitionResult.isFinal 特性為 false.)
SpeechRecognition.maxAlternatives
設定每個結果中 SpeechRecognitionAlternative 物件的最大數量。預設值為 1。
SpeechRecognition.serviceURI
指定當前的 SpeechRecognition 使用哪個地區的語音辨識服務來辨識語音。預設為使用者裝置的預設語音服務

事件處理

SpeechRecognition.onaudiostart
當使用者的裝置開始捕捉聲音時觸發。
SpeechRecognition.onaudioend
當使用者的裝置結束捕捉聲音時觸發。
SpeechRecognition.onend
當 speech recognition 服務中斷連線時觸發。
SpeechRecognition.onerror
當 speech recognition 發生錯誤時觸發。
SpeechRecognition.onnomatch
Fired when the speech recognition service returns a final result with no significant recognition. This may involve some degree of recognition, which doesn't meet or exceed the confidence threshold.
SpeechRecognition.onresult
Fired when the speech recognition service returns a result — a word or phrase has been positively recognized and this has been communicated back to the app.
SpeechRecognition.onsoundstart
Fired when any sound — recognisable speech or not — has been detected.
SpeechRecognition.onsoundend
Fired when any sound — recognisable speech or not — has stopped being detected.
SpeechRecognition.onspeechstart
Fired when sound that is recognised by the speech recognition service as speech has been detected.
SpeechRecognition.onspeechend
Fired when speech recognised by the speech recognition service has stopped being detected.
SpeechRecognition.onstart
Fired when the speech recognition service has begun listening to incoming audio with intent to recognize grammars associated with the current SpeechRecognition.

方法

SpeechRecognition also inherits methods from its parent interface, EventTarget.

SpeechRecognition.abort()
Stops the speech recognition service from listening to incoming audio, and doesn't attempt to return a SpeechRecognitionResult.
SpeechRecognition.start()
Starts the speech recognition service listening to incoming audio with intent to recognize grammars associated with the current SpeechRecognition.
SpeechRecognition.stop()
Stops the speech recognition service from listening to incoming audio, and attempts to return a SpeechRecognitionResult using the audio captured so far.

範例

In our simple Speech color changer example, we create a new SpeechRecognition object instance using the SpeechRecognition() constructor, create a new SpeechGrammarList, and set it to be the grammar that will be recognised by the SpeechRecognition instance using the SpeechRecognition.grammars property.

After some other values have been defined, we then set it so that the recognition service starts when a click event occurs (see SpeechRecognition.start().) When a result has been successfully recognised, the SpeechRecognition.onresult handler fires,  we extract the color that was spoken from the event object, and then set the background color of the <html> element to that colour.

var grammar = '#JSGF V1.0; grammar colors; public <color> = aqua | azure | beige | bisque | black | blue | brown | chocolate | coral | crimson | cyan | fuchsia | ghostwhite | gold | goldenrod | gray | green | indigo | ivory | khaki | lavender | lime | linen | magenta | maroon | moccasin | navy | olive | orange | orchid | peru | pink | plum | purple | red | salmon | sienna | silver | snow | tan | teal | thistle | tomato | turquoise | violet | white | yellow ;'
var recognition = new SpeechRecognition();
var speechRecognitionList = new SpeechGrammarList();
speechRecognitionList.addFromString(grammar, 1);
recognition.grammars = speechRecognitionList;
//recognition.continuous = false;
recognition.lang = 'en-US';
recognition.interimResults = false;
recognition.maxAlternatives = 1;

var diagnostic = document.querySelector('.output');
var bg = document.querySelector('html');

document.body.onclick = function() {
  recognition.start();
  console.log('Ready to receive a color command.');
}

recognition.onresult = function(event) {
  var color = event.results[0][0].transcript;
  diagnostic.textContent = 'Result received: ' + color;
  bg.style.backgroundColor = color;
}

規格

Specification Status Comment
Web Speech API
The definition of 'SpeechRecognition' in that specification.
Draft  

瀏覽器相容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 33webkit [1] No support [2] No support No support No support
continuous 33 [1] No support No support No support No support
Feature Android Chrome Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile
Basic support ? (Yes)[1] 44.0 (44) 2.5 No support No support No support
continuous ? (Yes)[1] ? No support No support No support No support
  • [1] Speech recognition interfaces are currently prefixed in Chrome, so you'll need to prefix interface names appropriately, e.g. webkitSpeechRecognition; You'll also need to serve your code through a web server for recognition to work.
  • [2] Can be enabled via the media.webspeech.recognition.enable flag in about:config on mobile. Not implemented at all on Desktop Firefox — see bug 1248897.

Firefox OS 權限

欲在你的APP裡面使用語音辨識功能,你必須在APP的manifest中要求下列權限:

"permissions": {
  "audio-capture" : {
    "description" : "Audio capture"
  },
  "speech-recognition" : {
    "description" : "Speech recognition"
  }
}

你的APP也必須是一個privileged app,所以你同時需要加入

  "type": "privileged"

瞭解更多

文件標籤與貢獻者

此頁面的貢獻者: a08449bc, CCChou, hinet60613
最近更新: a08449bc,