SpeechRecognitionResult
Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
The SpeechRecognitionResult
interface of the Web Speech API represents a single recognition match, which may contain multiple SpeechRecognitionAlternative
(en-US) objects.
Properties
SpeechRecognitionResult.isFinal
只读-
A
Boolean
(en-US) that states whether this result is final (true) or not (false) — if so, then this is the final time this result will be returned; if not, then this result is an interim result, and may be updated later on. SpeechRecognitionResult.length
(en-US) 只读-
Returns the length of the "array" — the number of
SpeechRecognitionAlternative
(en-US) objects contained in the result (also referred to as "n-best alternatives".)
Methods
SpeechRecognitionResult.item
(en-US)-
A standard getter that allows
SpeechRecognitionAlternative
(en-US) objects within the result to be accessed via array syntax.
Examples
This code is excerpted from our Speech color changer example.
recognition.onresult = function(event) {
// The SpeechRecognitionEvent results property returns a SpeechRecognitionResultList object
// The SpeechRecognitionResultList object contains SpeechRecognitionResult objects.
// It has a getter so it can be accessed like an array
// The first [0] returns the SpeechRecognitionResult at position 0.
// Each SpeechRecognitionResult object contains SpeechRecognitionAlternative objects that contain individual results.
// These also have getters so they can be accessed like arrays.
// The second [0] returns the SpeechRecognitionAlternative at position 0.
// We then return the transcript property of the SpeechRecognitionAlternative object
var color = event.results[0][0].transcript;
diagnostic.textContent = 'Result received: ' + color + '.';
bg.style.backgroundColor = color;
}
Specifications
Specification |
---|
Web Speech API # speechreco-result |
Browser compatibility
BCD tables only load in the browser