react-native-twilio-voice-sdk

This is a React Native wrapper for Twilio Programmable Voice SDK that lets you make (and in the future receive) calls from your ReactNative App. This module is not curated nor maintained, but inspired by Twilio.

The initial version of this library was forked from react-native-twilio-programmable-voice in order to update Twilio's programmable Voice SDK libraries to their latest version. This is specially important because version 2 of Twilio's libraries used by react-native-twilio-programmable-voice is going to be deprecated by Jan, 1st 2020. In order to simplify the migration, only the making calls part was migrated.

Twilio Programmable Voice SDK

• Android 4.1.0
• iOS 4.1.0

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.

This library only intends to support React Native versions over 0.60. This doesn't mean that it won't work with previous versions, just that issues related to previous versions of RN won't be actively tracked by the mantainer.

npm install react-native-twilio-voice-sdk --save

Usage

The library tries to mimic the Twilio Voice SDK API for Android and iOS with some idiomatic changes for Javascript.

The SDK is composed of several key classes illustrated in the image below.

The class TwilioVoice is the entry point into the SDK and does the following:

• Make outgoing calls with TwilioVoice.connect(...)
• The class Call represents an outgoing call.

Code example

1import TwilioVoice from 'react-native-twilio-voice-sdk'
2
3// Get the library version
4TwilioVoice.version
5
6// Get the underlying native TwilioVoice library version
7TwilioVoice.nativeVersion
8
9// Subscribe to call events
10let call
11const removeSubscription = TwilioVoice.on("connect", connectedCall => call = connectedCall)
12// call removeSubscription() to stop listening
13
14// start a call
15TwilioVoice.connect(accessToken, {to: '+61234567890'})
16
17// hangup
18call.disconnect()
19
20// mute or un-mute the call
21// mutedValue must be a boolean
22call.muted(mutedValue)
23
24// Send the call audio to the speaker phone
25// speakerPhoneEnabled must be a boolean
26call.setSpeakerPhone(speakerPhoneEnabled)
27
28call.sendDigits(digits)
29
30// Call properties
31call.from
32call.to
33call.sid
34call.state // "RINGING" | "CONNECTING" | "CONNECTED" | "RECONNECTING" | "DISCONNECTED"

Events

All calls to the on method return a function that removes the subscription upon execution.

1TwilioVoice.on('ringing', function(call: Call): void);
2TwilioVoice.on('connect', function(call: Call): void);
3TwilioVoice.on('connectFailure', function(call: Call, err?: Error): void);
4TwilioVoice.on('reconnecting', function(call: Call, err?: Error): void);
5TwilioVoice.on('reconnect', function(call: Call): void);
6TwilioVoice.on('disconnect', function(call: Call, err?: Error): void);

Twilio Voice SDK reference

iOS changelog

Android changelog

Credits

react-native-twilio-programmable-voice

voice-quickstart-android

react-native-push-notification

voice-quickstart-objc

License

MIT