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

SpeechRecognition: start() method

· 52CE 我爱测

The **`start()`** method of the Web Speech API starts the speech recognition service to listen for incoming audio (from a microphone or an audio track) and returns the results of that recognition.

Web Speech API

The start() method of the Web Speech API starts the speech recognition service to listen for incoming audio (from a microphone or an audio track) and returns the results of that recognition.

Syntax

start()
start(audioTrack)

Parameters

  • audioTrack
    • : A MediaStreamTrack instance to perform speech recognition on. If not specified, the service attempts to recognize audio from the user's microphone instead.

Return value

None (undefined).

Exceptions

  • InvalidStateError DOMException
    • : Thrown if an audioTrack is specified and one or both of the following are true:
      • The track's MediaStreamTrack.kind property is not audio.
      • The track's MediaStreamTrack.readyState property is not live.

Examples

Recognizing speech from a microphone

In our Speech color changer example, we create a new SpeechRecognition object instance using the SpeechRecognition.SpeechRecognition constructor. Later on, we create a click event handler on a <button> so that when it's clicked, we start the speech recognition service and await audio input from the user's microphone:

const recognition = new SpeechRecognition();

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.");
};

When a result has been successfully recognized, the SpeechRecognition.result_event event fires. We extract the color that was spoken from the event object by grabbing the SpeechRecognitionAlternative.transcript of the first SpeechRecognitionAlternative of the first SpeechRecognitionResult in the returned SpeechRecognitionEvent.results list. We then set the background color of the html element to that color.

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

Recognizing speech from an audio track

This code (excerpted from our audio track recognition demo) shows how to recognize speech from an audio track. To begin with, we create a new SpeechRecognition instance and set its SpeechRecognition.lang to en-US. We then grab a reference to a button element and a p element to output results and diagnostic information.

const recognition = new SpeechRecognition();
recognition.lang = "en-US";

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

Next, we add a click event handler to the <button>. When it is clicked, we create a new audio element using the HTMLAudioElement.Audio constructor and load an MP3 file into it. Once the MP3 is ready to play (determined by the HTMLMediaElement.canplay_event event), we capture it as a MediaStream using the HTMLMediaElement.captureStream method, then extract its audio MediaStreamTrack using MediaStream.getAudioTracks.

We then play the audio (required for the recognition to take place), and pass the MediaStreamTrack into the start() method to start the recognition.

startBtn.addEventListener("click", () => {
  diagnostic.textContent = "";
  console.log("Loading audio track");
  const audioElement = new Audio("cheese-on-toast.mp3");
  audioElement.addEventListener("canplay", () => {
    const stream = audioElement.captureStream();
    const audioTrack = stream.getAudioTracks()[0];
    audioElement.play();
    recognition.start(audioTrack);
    console.log("Recognition started");
  });
});

To output the recognized audio, we listen for the SpeechRecognition.result_event event. When that fires, we grab the SpeechRecognitionAlternative.transcript of the first SpeechRecognitionAlternative of the first SpeechRecognitionResult in the returned SpeechRecognitionEvent.results list. We output the transcript itself to the output <p> and log its confidence rating to the console.

recognition.addEventListener("result", (event) => {
  const speech = event.results[0][0].transcript;
  diagnostic.textContent = `Speech recognized: ${speech}.`;
  console.log(`Confidence: ${event.results[0][0].confidence}`);
});

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

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

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