speech-to-text
v2.9.1
Published
A speech to text module.
Downloads
1,732
Readme
Speech To Text
A speech recognition module to convert speech into text.
Install
npm install speech-to-text
Typical Usage
Here is the module being used in a React component
componentDidMount() {
const onAnythingSaid = text => {
this.setState({ interimText: text });
};
const onEndEvent = () => {
if (this.state.listening) {
this.startListening();
}
};
const onFinalised = text => {
this.setState({
finalisedText: [text, ...this.state.finalisedText],
interimText: ''
});
};
try {
this.listener = new SpeechToText(onFinalised, onEndEvent, onAnythingSaid);
} catch (error) {
this.setState({ error: error.message });
}
}
Above demo here.
API
The constructor
- onFinalised - a callback that will be passed the finalised transcription from the cloud. Slow, but accuate.
- onEndEvent - a callback that will be called when the end event is fired (speech recognition engine disconnects).
- onAnythingSaid - (optional) a callback that will be passed interim transcriptions. Fairly immediate, but less accurate than finalised text.
- language - (optional) the language to interpret against. Default is US English, and the supported languages are listed here.
The constructor will throw an error if speech recognition is not supported by the browser. Currently only Chrome is supported.
if (!('webkitSpeechRecognition' in window)) {
throw new Error("This browser doesn't support speech recognition. Try Google Chrome.");
}
startListening
Initiates listening to speech input.
stopListening
Does just that. Stops listening.
License
MIT