大网数据广告活动
Web 标准与前端开发

SpeechRecognition

· 52CE 我爱测

The **`SpeechRecognition`** interface of the Web Speech API is the controller interface for the recognition service; this also handles the SpeechRecognitionEvent sent from the recognition service.

Web Speech API

The SpeechRecognition interface of the Web Speech API is the controller interface for the recognition service; this also handles the SpeechRecognitionEvent sent from the recognition service.

[!NOTE] On some browsers, like Chrome, using Speech Recognition on a web page involves a server-based recognition engine. Your audio is sent to a web service for recognition processing, so it won't work offline.

Constructor

  • SpeechRecognition.SpeechRecognition
    • : Creates a new SpeechRecognition object.

Instance properties

SpeechRecognition also inherits properties from its parent interface, EventTarget.

  • SpeechRecognition.lang
    • : Returns and sets the language of the current SpeechRecognition. If not specified, this defaults to the HTML lang attribute value, or the user agent's language setting if that isn't set either.
  • SpeechRecognition.continuous
    • : Controls whether continuous results are returned for each recognition, or only a single result. Defaults to single (false.)
  • SpeechRecognition.interimResults
    • : Controls whether interim results should be returned (true) or not (false.) Interim results are results that are not yet final (e.g., the SpeechRecognitionResult.isFinal property is false.)
  • SpeechRecognition.maxAlternatives
    • : Sets the maximum number of SpeechRecognitionAlternatives provided per result. The default value is 1.
  • SpeechRecognition.phrases
  • SpeechRecognition.processLocally
    • : Specifies whether speech recognition must be performed locally on the user's device.
  • SpeechRecognition.unspokenPunctuation
    • : Specifies whether the speech recognition engine will infer and insert punctuation marks based on the user's natural speech patterns.

Deprecated properties

The concept of grammar has been removed from the Web Speech API. Related features remain in the specification and are still recognized by supporting browsers for backwards compatibility, but they have no effect on speech recognition services.

  • SpeechRecognition.grammars
    • : Returns and sets a collection of SpeechGrammar objects that represent the grammars understood by the current SpeechRecognition.

Static methods

  • SpeechRecognition.available_static
    • : Checks whether the specified languages are available for speech recognition.
  • SpeechRecognition.install_static
    • : Installs the required language packs for on-device speech recognition in the specified languages.

Instance methods

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 to listen for incoming audio (from a microphone or an audio track) and returns the results of that recognition.
  • SpeechRecognition.stop()
    • : Stops the speech recognition service from listening for incoming audio and attempts to return a SpeechRecognitionResult based on the results captured so far.

Events

Listen to these events using addEventListener() or by assigning an event listener to the oneventname property of this interface.

  • audiostart
    • : Fired when the user agent has started to capture audio.
  • audioend
    • : Fired when the user agent has finished capturing audio.
  • end
    • : Fired when the speech recognition service has disconnected.
  • error
    • : Fired when a speech recognition error occurs.
  • nomatch
    • : 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 SpeechRecognitionAlternative.confidence threshold.
  • result
    • : 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.
  • soundstart
    • : Fired when any sound — recognizable speech or not — has been detected.
  • soundend
    • : Fired when any sound — recognizable speech or not — has stopped being detected.
  • speechstart
    • : Fired when sound that is recognized by the speech recognition service as speech has been detected.
  • speechend
    • : Fired when speech recognized by the speech recognition service has stopped being detected.
  • start
    • : Fired when the speech recognition service begins listening for audio to recognize.

Examples

In our Speech color changer example, we create a new SpeechRecognition object instance using the SpeechRecognition.SpeechRecognition constructor.

After some other values have been defined, we then set it so that the recognition service starts when a button is clicked (see SpeechRecognition.start()). When a result has been successfully recognized, the SpeechRecognition.result_event event fires, we extract the color that was spoken from the event object, and then set the background color of the html element to that color.

const recognition = new SpeechRecognition();
recognition.continuous = false;
recognition.lang = "en-US";
recognition.interimResults = false;
recognition.maxAlternatives = 1;

const diagnostic = document.querySelector(".output");
const bg = document.querySelector("html");
const startBtn = document.querySelector("button");

startBtn.onclick = () => {
  recognition.start();
  console.log("Ready to receive a color command.");
};

recognition.onresult = (event) => {
  const color = event.results[0][0].transcript;
  diagnostic.textContent = `Result received: ${color}`;
  bg.style.backgroundColor = color;
};

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。