react-native-android-speech

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