Skip to content

grvcoelho/react-voice-components

Repository files navigation

react-voice-components

Build Status

Set of React components that use the Web Speech API to bring voice experience to React applications. Check out the ✨ 💎 LIVE DEMO 💎 ✨

Install

Install the components using npm:

$ npm install --save react-voice-components

Usage

  1. Import components:
import { VoicePlayer, VoiceRecognition } from 'react-voice-components'
  1. 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

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

LICENSE

MIT (c) 2017 Guilherme Rv Coelho

About

Set of React components that use the Web Speech API to bring voice experience to React applications

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published