react-native-twilio-voice-module

This is twilio programmable voice module for react native that makes you allow to make inbound / outbound calls.

This is working with version 4.1.0 of twilio native ios / android sdks. (Version 2.x and 3.x will be deprecated at the end of 2019.)

Getting started

$ npm install react-native-twilio-voice-module --save

$ yarn add react-native-twilio-voice-module

Mostly automatic installation

$ react-native link react-native-twilio-voice-module

Manual installation

iOS

In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
Go to node_modules ➜ react-native-twilio-voice-module and add TwilioVoiceModule.xcodeproj
In XCode, in the project navigator, select your project. Add libTwilioVoiceModule.a to your project's Build Phases ➜ Link Binary With Libraries
Run your project (Cmd+R)<

Android

Open up android/app/src/main/java/[...]/MainApplication.java
- Add import com.reactlibrary.TwilioVoiceModulePackage; to the imports at the top of the file
- Add new TwilioVoiceModulePackage() to the list returned by the getPackages() method

Append the following lines to android/settings.gradle:

include ':react-native-twilio-voice-module'
project(':react-native-twilio-voice-module').projectDir = new File(rootProject.projectDir,  '../node_modules/react-native-twilio-voice-module/android')

Insert the following lines inside the dependencies block in android/app/build.gradle:
```
  compile project(':react-native-twilio-voice-module')
```
Permissions
For iOS, you have to add Microphone usage description in info.plist.
For Android, open AndroidManifest.xml file and add the following permissions.

<uses-permission android:name="android.permission.RECORD_AUDIO" />

<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<uses-feature android:name="android.hardware.sensor.proximity" android:required="true" />

Next under <application> tag, add the firebase messaging service
```
    <service android:name="com.twiliovoicemodule.fcm.VoiceCallFCMService">

          <intent-filter>

              <action android:name="com.google.firebase.MESSAGING_EVENT"/>

          </intent-filter>

    </service>
```

Usage

You will be required to follow iOS Quickstart step 2 ~ step 9 and Android Quickstart step 2 ~ step 9 to gain access token and to receive call invite.

Here are supported event listeners:

deviceRegistered - Device is registered successfully to receive call incoming. It means FCM token is registered for android and device token is registered for iOS
deviceNotRegistered - Device is not registered. Maybe invalid token issue.
connectionDidConnect - Call has connected
connectionDidFailed - Call has failed to connect
connectionDidRinging - Called party is being alerted of a Call
connectionDidReconnecting - Call starts to reconnect due to network change event
connectionDidReconnect - Call is reconnected
connectionDidDisconnect - Call has disconnected
callIncoming - A call is incoming to your device
callIncomingCancelled - A incoming call is cancelled

You should add these event listeners before you initialize TwilioVoiceModule with access token.

import TwilioVoiceModule from 'react-native-twilio-voice-module';

componentDidMount() {
  TwilioVoiceModule.addEventListener('deviceRegistered', this.deviceRegistered);
  TwilioVoiceModule.addEventListener('connectionDidConnect', this.connectionDidConnect);
  // Add more listeners

  TwilioVoiceModule.initWithToken(token).then(res => {
    // true if initialized,
    // false if something went wrong
  });  
}

componentWillUnmount() {
  TwilioVoiceModule.removeEventListener('deviceRegistered', this.deviceRegistered);
  TwilioVoiceModule.removeEventListener('connectionDidConnect', this.connectionDidConnect);
  // Remove added listeners
}

deviceRegistered = () => {
  // Now your device is allowed to receive incoming inbound calls.
}

connectionDidConnect = (call) => {
  // call.call_sid
  // call.call_state
  // call.call_from
  // call.call_to
}

Now you are ready to make a call.

TwilioVoiceModule.addEventListener('callIncoming', this.callIncoming);
TwilioVoiceModule.addEventListener('callIncomingCancelled', this.callIncomingCancelled);

// outbound call example
TwilioVoiceModule.connect({
  To: '+123456789',
  From: '+987654321'
});

//inbound call example
TwilioVoiceModule.connect({
  To: 'John'
});

callIncoming = (call) => {
  // ... maybe open dialog with accept / reject button

  // Accept the call
  TwilioVoiceModule.accept();

  // Reject the call
  TwilioVoiceModule.reject();
}

callIncomingCancelled = (cancelledCall) => {

}

To disconnect call, just call TwilioVoiceModule.disconnect()

Android ProGuard Rules

    # Twilio Programmable Voice
    -keep class com.twilio.** { *; }
    -keep class tvo.webrtc.** { *; }
    -dontwarn tvo.webrtc.**
    -keep class com.twilio.voice.** { *; }
    -keepattributes InnerClasses

Other APIs that you may need.

TwilioVoiceModule.getVersion((version) => {
  // Twilio sdk version. Actually 4.1.0
});

const activeCall = await TwilioVoiceModule.getActiveCall();

TwilioVoiceModule.setMuted(true); // mute the sound

TwilioVoiceModule.setSpeakerPhone(true); // set the speaker on.

TwilioVoiceModule.sendDigits('12345'); // send IVR digits