react-native-twilio-v5-test
v1.0.2
Published
React Native wrapper for Twilio Voice SDK v5 [TEST]
Downloads
11
Readme
react-native-twilio-programmable-voice
This is a React Native wrapper for Twilio Programmable Voice SDK that lets you make and receive calls from your React Native App. This module is not affiliated with or maintained by the Twilio team. This is maintained by contributions from the community.
Twilio Programmable Voice SDK
- Android 5.0.2 (bundled within this library)
- iOS 5.1.1 (specified by the app's own podfile; min. version 5.x)
Breaking changes in v4.0.0
- Android: remove the following block from your application's
AndroidManifest.xml
<!-- [START instanceId_listener] -->
<service
android:name="com.hoxfon.react.TwilioVoice.fcm.VoiceFirebaseInstanceIDService"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.iid.InstanceID" />
</intent-filter>
</service>
<!-- [END instanceId_listener] -->
iOS: params changes for
connectionDidConnect
andconnectionDidDisconnect
to => call_to from => call_from error => err
Breaking changes in v3.0.0
- initWitToken returns an object with a property
initialized
instead ofinitilized
- iOS event
connectionDidConnect
returns the same properties as Android move propertyto
=>call_to
move propertyfrom
=>call_from
Help wanted!
There is no need to ask permissions to contribute. Just open an issue or provide a PR. Everybody is welcome to contribute.
ReactNative success is directly linked to its module ecosystem. One way to make an impact is helping contributing to this module or another of the many community lead ones.
Installation
Before starting, we recommend you get familiar with Twilio Programmable Voice SDK. It's easier to integrate this module into your react-native app if you follow the Quick start tutorial from Twilio, because it makes very clear which setup steps are required. On RN 0.60+, this module can be auto-linked (Android still requires FCM setup below).
npm install react-native-twilio-programmable-voice --save
react-native link react-native-twilio-programmable-voice
iOS Installation - when projects made with react-native init
After you have linked the library with react-native link react-native-twilio-programmable-voice
check that libRNTwilioVoice.a
is present under YOUR_TARGET > Build Phases > Link Binaries With Libraries. If it is not present you can add it using the + sign at the bottom of that list.
Edit your Podfile
to include TwilioVoice framework
source 'https://github.com/cocoapods/specs'
# min version for TwilioVoice to work
platform :ios, '10.0'
target <YOUR_TARGET> do
...
pod 'TwilioVoice', '~> 5.1.1'
...
end
run pod install
from inside your project ios
directory
iOS Installation - when projects made without react-native init
Edit your Podfile
to include TwilioVoice and RNTwilioVoice frameworks
source 'https://github.com/cocoapods/specs'
# min version for TwilioVoice to work
platform :ios, '10.0'
target <YOUR_TARGET> do
...
pod 'TwilioVoice', '~> 5.1.1'
pod 'RNTwilioVoice', path: '../node_modules/react-native-twilio-programmable-voice'
...
end
run pod install
from inside your project ios
directory
CallKit
The current iOS part of this library works through CallKit. Because of this the call flow is much simpler than on Android as CallKit handles the inbound calls answering, ignoring, or rejecting. Because of CallKit, the only event listeners present are "deviceReady", "connectionDidConnect", "connectionDidDisconnect", and "callRejected".
VoIP Service Certificate
Twilio Programmable Voice for iOS utilizes Apple's VoIP Services and VoIP "Push Notifications" instead of FCM. You will need a VoIP Service Certificate from Apple to receive calls.
Android Installation
Setup FCM
You must download the file google-services.json
from the Firebase console.
It contains keys and settings for all your applications under Firebase. This library obtains the resource senderID
for registering for remote GCM from that file.
NOTE: To use a specific play-service-gcm
version, update the compile
instruction in your App's android/app/build.gradle
(replace 10.+
with the version you prefer):
...
buildscript {
...
dependencies {
classpath 'com.google.gms:google-services:4.2.0'
}
}
...
dependencies {
...
// on React Native 0.60+, this module can be auto-linked and doesn't need a manual entry here
implementation project(':react-native-twilio-programmable-voice')
}
// this plugin looks for google-services.json in your project
apply plugin: 'com.google.gms.google-services'
In your AndroidManifest.xml
.....
<uses-permission android:name="android.permission.VIBRATE" />
<application ....>
....
<!-- Twilio Voice -->
<!-- [START fcm_listener] -->
<service
android:name="com.hoxfon.react.RNTwilioVoice.fcm.VoiceFirebaseMessagingService">
<intent-filter>
<action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter>
</service>
<!-- [END fcm_listener] -->
.....
In android/settings.gradle
(not necessary if auto-linking on RN 0.60+)
...
include ':react-native-twilio-programmable-voice'
project(':react-native-twilio-programmable-voice').projectDir = file('../node_modules/react-native-twilio-programmable-voice/android')
Register module (in MainApplication.java
) (not necessary if auto-linking on RN 0.60+ unless you want to control microphone permission)
import com.hoxfon.react.RNTwilioVoice.TwilioVoicePackage; // <--- Import Package
public class MainApplication extends Application implements ReactApplication {
private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {
@Override
protected boolean getUseDeveloperSupport() {
return BuildConfig.DEBUG;
}
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
new TwilioVoicePackage() // <---- Add the package
// new TwilioVoicePackage(false) // <---- pass false if you don't want to ask for microphone permissions
);
}
};
....
}
Usage
import TwilioVoice from 'react-native-twilio-programmable-voice'
// ...
// initialize the Programmable Voice SDK passing an access token obtained from the server.
// Listen to deviceReady and deviceNotReady events to see whether the initialization succeeded.
async function initTelephony() {
try {
const accessToken = await getAccessTokenFromServer()
const success = await TwilioVoice.initWithToken(accessToken)
} catch (err) {
console.err(err)
}
}
// iOS Only
function initTelephonyWithUrl(url) {
TwilioVoice.initWithTokenUrl(url)
try {
TwilioVoice.configureCallKit({
appName: 'TwilioVoiceExample', // Required param
imageName: 'my_image_name_in_bundle', // OPTIONAL
ringtoneSound: 'my_ringtone_sound_filename_in_bundle' // OPTIONAL
})
} catch (err) {
console.err(err)
}
}
Events
// add listeners (flowtype notation)
TwilioVoice.addEventListener('deviceReady', function() {
// no data
})
TwilioVoice.addEventListener('deviceNotReady', function(data) {
// {
// err: string
// }
})
TwilioVoice.addEventListener('connectionDidConnect', function(data) {
// Android
// {
// call_sid: string, // Twilio call sid
// call_state: 'PENDING' | 'CONNECTED' | 'ACCEPTED' | 'CONNECTING' 'DISCONNECTED' | 'CANCELLED',
// call_from: string, // "+441234567890"
// call_to: string, // "client:bob"
// }
// iOS
// {
// call_sid: string, // Twilio call sid
// call_state: 'PENDING' | 'CONNECTED' | 'ACCEPTED' | 'CONNECTING' 'DISCONNECTED' | 'CANCELLED',
// from: string, // "+441234567890" // issue 44 (https://github.com/hoxfon/react-native-twilio-programmable-voice/issues/44)
// to: string, // "client:bob" // issue 44 (https://github.com/hoxfon/react-native-twilio-programmable-voice/issues/44)
// }
})
TwilioVoice.addEventListener('connectionDidDisconnect', function(data: mixed) {
// | null
// | {
// err: string
// }
// | Android
// {
// call_sid: string, // Twilio call sid
// call_state: 'PENDING' | 'CONNECTED' | 'ACCEPTED' | 'CONNECTING' 'DISCONNECTED' | 'CANCELLED',
// call_from: string, // "+441234567890"
// call_to: string, // "client:bob"
// err?: string,
// }
// | iOS
// {
// call_sid: string, // Twilio call sid
// call_state: 'PENDING' | 'CONNECTED' | 'ACCEPTED' | 'CONNECTING' 'DISCONNECTED' | 'CANCELLED',
// call_from?: string, // "+441234567890"
// call_to?: string, // "client:bob"
// from?: string, // "+441234567890" // issue 44 (https://github.com/hoxfon/react-native-twilio-programmable-voice/issues/44)
// to?: string, // "client:bob" // issue 44 (https://github.com/hoxfon/react-native-twilio-programmable-voice/issues/44)
// error?: string, // issue 44 (https://github.com/hoxfon/react-native-twilio-programmable-voice/issues/44)
// }
})
// iOS Only
TwilioVoice.addEventListener('callRejected', function(value: 'callRejected') {})
// Android Only
TwilioVoice.addEventListener('deviceDidReceiveIncoming', function(data) {
// {
// call_sid: string, // Twilio call sid
// call_state: 'PENDING' | 'CONNECTED' | 'ACCEPTED' | 'CONNECTING' 'DISCONNECTED' | 'CANCELLED',
// call_from: string, // "+441234567890"
// call_to: string, // "client:bob"
// }
})
// Android Only
TwilioVoice.addEventListener('proximity', function(data) {
// {
// isNear: boolean
// }
})
// Android Only
TwilioVoice.addEventListener('wiredHeadset', function(data) {
// {
// isPlugged: boolean,
// hasMic: boolean,
// deviceName: string
// }
})
// ...
// start a call
TwilioVoice.connect({To: '+61234567890'})
// hangup
TwilioVoice.disconnect()
// accept an incoming call (Android only, in iOS CallKit provides the UI for this)
TwilioVoice.accept()
// reject an incoming call (Android only, in iOS CallKit provides the UI for this)
TwilioVoice.reject()
// ignore an incoming call (Android only)
TwilioVoice.ignore()
// mute or un-mute the call
// mutedValue must be a boolean
TwilioVoice.setMuted(mutedValue)
TwilioVoice.sendDigits(digits)
// should be called after the app is initialized
// to catch incoming call when the app was in the background
TwilioVoice.getActiveCall()
.then(incomingCall => {
if (incomingCall){
_deviceDidReceiveIncoming(incomingCall)
}
})
// Unregister device with Twilio (iOS only)
TwilioVoice.unregister()
Twilio Voice SDK reference
Credits
react-native-push-notification
License
MIT