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
InvalidStateErrorDOMException- : Thrown if an
audioTrackis 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.
- The track's MediaStreamTrack.kind property is not
- : Thrown if an
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。离线整理了版式、链接和媒体显示。
