react-voice-components
Set of React components that use the Web Speech API to bring voice experience to React applications. Check out the
Install
Install the components using npm:
$ npm install --save react-voice-components
Usage
- Import components:
import { VoicePlayer, VoiceRecognition } from 'react-voice-components'
- Use it:
ReactDOM.render(
<VoicePlayer
play
text="React voice player demonstration"
/>,
document.getElementById('root')
)
API
<VoicePlayer />
Provides you a simple React component to do speech synthesis (text to speech).
Options
| Property | Options | Description |
|---|---|---|
| play | boolean | Specifies if the speech should be played when mounted. |
| pause | boolean | Specifies if the speech should pause |
| text | string | Specifies the text that shall be spoken. |
| lang | en-US, en-GB, es-ES, fr-FR, it-IT, de-DE, ja-JP, pt-BR, zh-CN |
Specifies the accent and language the speech will be spoken. |
Event Callbacks
| Property | Description |
|---|---|
| onStart | Runs when the speech starts to be spoken. |
| onEnd | Runs when the speech completes to be spoken. |
| onPause | Runs when te speech is paused. |
| onResume | Runs when the speech is resumed. |
<VoiceRecognition />
Provides you a simple React component to do voice recognition (speech to text).
Options
| Property | Options | Description |
|---|---|---|
| continuous | boolean | Specifies if the recognition should continue when the user pauses while speaking. |
| stop | boolean | Specifies if the recognition should be stoped (when used with continuous=true) |
Event Callbacks
| Property | Description |
|---|---|
| onStart | Runs when the recognition starts. |
| onEnd | Runs when the recognition ends. |
| onError | Runs when there is a recognition error. |
| onResult | Runs when there is a recognition result. |
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -m 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D
LICENSE
MIT (c) 2017 Guilherme Rv Coelho
