SpeechRecognitionResult

SpeechRecognitionResultWeb 语音 API 中的一个接口,表示单个识别匹配,其中可能包含多个 SpeechRecognitionAlternative 对象。

实例属性

SpeechRecognitionResult.isFinal 只读

一个布尔值,表示此结果是最终结果(true)还是非最终结果(false)——如果是,那么这是此结果最后一次返回;如果不是,那么此结果是临时结果,可能在稍后更新。

SpeechRecognitionResult.length 只读

返回“数组”的长度——结果中包含的 SpeechRecognitionAlternative 对象的数量(也称为“n-best 备选方案”。

实例方法

SpeechRecognitionResult.item

一个标准的 getter,允许通过数组语法访问结果中的 SpeechRecognitionAlternative 对象。

示例

此代码摘自我们的 语音颜色更改器 示例。

js
recognition.onresult = (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
  const color = event.results[0][0].transcript;
  diagnostic.textContent = `Result received: ${color}.`;
  bg.style.backgroundColor = color;
};

规范

规范
Web 语音 API
# speechreco-result

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅