Miss any of our Open RFC calls?Watch the recordings here! »

react-native-android-speech

0.0.6 • Public • Published

React Native Android Text Top Speech

A react native android wrapper for Text To speech

Purpose

Currently , React Native doesn't have inbuilt support for TextToSpeech library for Android.

But with help of exposing module in react-native , this wrapper will solve the problem for TTS.

Setup

  • Install Module
npm install --save-dev react-native-android-speech
  • android/settings.gradle
...
include ':react-native-android-speech'
project(':react-native-android-speech').projectDir = new File(settingsDir, '../node_modules/react-native-android-speech')
  • android/app/build.gradle
dependencies {
    ...
    compile project(':react-native-android-speech')
}
  • register module (in MainActivity.java)
...
import com.mihir.react.tts.*; // Import package 
 
public class MainActivity extends Activity implements DefaultHardwareBackBtnHandler {
    ...
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mReactRootView = new ReactRootView(this);
 
        mReactInstanceManager = ReactInstanceManager.builder()
                .setApplication(getApplication())
                .setBundleAssetName("index.android.bundle")
                .setJSMainModuleName("index.android")
                .addPackage(new MainReactPackage())
                .addPackage(new RCTTextToSpeechModule())           // Add any extra modules here 
                .setUseDeveloperSupport(BuildConfig.DEBUG)
                .setInitialLifecycleState(LifecycleState.RESUMED)
                .build();
 
        mReactRootView.startReactApplication(mReactInstanceManager, "YourProject", null);
 
        setContentView(mReactRootView);
    }
}

Usage

Currently there following functionality available. All below functions return Promise , with proper error codes.

  • getLocales
  • speak(args)
  • isSpeaking
  • shutDown
  • stop

Importing module

var tts = require('react-native-android-speech')
 

getLocales()

Returns all avialbale langauges from TTS make sure that exists in device also.

Example

tts.getLocales().then(locales=>{
    console.log(locales)
});
 

speak()

Example

tts.speak({
    text:'Please provide some text to speak.', // Mandatory
    pitch:1.5, // Optional Parameter to set the pitch of Speech,
    forceStop : false , //  Optional Parameter if true , it will stop TTS if it is already in process
    language : 'en' // Optional Paramenter Default is en you can provide any supported lang by TTS
}).then(isSpeaking=>{
    //Success Callback
    console.log(isSpeaking);
}).catch(error=>{
    //Errror Callback
    console.log(error)
});
 

isSpeaking()

This method will help to figure out wheter TTS engine is currently speaking or not.

Example

tts.isSpeaking()
.then(isSpeaking=>{
    //Callback
    console.log(isSpeaking);
})
.catch(error=>{
    //if it fails 
    console.log(error)
});
 

Stop()

Stop currently processing speech. Return True/False

Example

tts.shutDown()
.then(isStopped=>{
    console.log(isStopped);
})
.catch(error=>{
    console.log(error);
});
 

shutDown()

Shutdown TTS Engine

Example

tts.shutDown()
.then(shutDown=>{
    //Callback 
    console.log(shutDown);
})
.catch(error=>{
    console.log(error)
});
 

Changes

PR's are welcome

Todo

  • providing UternceId and callback
  • Differnt Voices
  • Custome Engines
  • Support Speech To Text

LICENSE

MIT

Install

npm i react-native-android-speech

DownloadsWeekly Downloads

11

Version

0.0.6

License

MIT

Last publish

Collaborators

  • avatar