- Android 21+, gradle 8+, kotlin 1.9+
- iOS 15+, swift 5.x
Execute the following commands from the repository root folder
npm i
cd example
# nano www/js/config.js use your own keys
npm i
cordova platform add ios/android
cordova run ios/android
Open the terminal in your Cordova-App folder and run the following commands
cordova plugin add @kaleyra/video-cordova-plugin
In order to enable the broadcast screen sharing tool in your cordova app you must add the plugin providing some settings. For more information please take a look at Kaleyra Video Broadcast Extension Cordova Plugin documentation.
Link the local plugin to the project
# cd to your application folder
cordova plugin add ${path-to-local-plugin} --link
cordova plugin remove @kaleyra/video-cordova-plugin
Every time you update the plugin remove the platforms 'android' and/or 'ios' and re add them to ensure that all modified plugins are copied to build folders remove platforms 'android' and/or 'ios' and re add them to ensure that all modified plugins are copied to build folders
cd {to your app root folder}
# Add --nosave if you don't want to update your package.json file when executing the commands below
cordova platforms remove android ios
cordova platforms add android ios
cordova run ios
cordova run android
You can refer to the Kaleyra Video plugin in your React Native app via
KaleyraVideo
The first thing you need to do is to configure the plugin specifying your keys and your options.
var kaleyraVideo = KaleyraVideo.configure({
environment: KaleyraVideo.environments.sandbox(), // production()
appID: 'mAppId_xxx', // your mobile appId
region: KaleyraVideo.regions.europe(), // india(), us()
logEnabled: true, // enable the logger
tools: { // by default no tools will be set
chat: {
audioCallOption: {
type: KaleyraVideo.audioCallTypes.AUDIO, // AUDIO or AUDIO_UPGRADABLE
recordingType: KaleyraVideo.recordingTypes.NONE, // NONE, MANUAL or AUTOMATIC
},
videoCallOption: {
recordingType: KaleyraVideo.recordingTypes.NONE, // NONE, MANUAL or AUTOMATIC
}
},
fileShare: true,
whiteboard: true,
screenShare: {
inApp: true, // screenshare only the app
wholeDevice: true // screenshare the whole device
},
feedback: true
},
// optional you can set one or more of the following capabilities, by default CallKit is enabled
iosConfig: {
voipHandlingStrategy: KaleyraVideo.voipHandlingStrategies.AUTOMATIC, // implement to be able to receive VoIPs
callkit: {
enabled: true, // enable CallKit on iOS 10+
appIconName: "logo_transparent", // optional but recommended
ringtoneSoundName: "custom_ringtone.mp3" // optional
}
}
});
If screenShare.wholeDevice is set to true look here for the required additional setup.
To listen for events and/or errors register Check the documentation here for a complete list.
Example:
kaleyraVideo.on(KaleyraVideo.events.callModuleStatusChanged, function (status) {});
If you desire to use VoIP notifications on iOS platform as first thing you should configure kaleyraVideo passing a config object as follow:
var kaleyraVideo = KaleyraVideo.configure({
[...]
iosConfig: {
voipHandlingStrategy: KaleyraVideo.voipHandlingStrategies.AUTOMATIC,
[...]
}
});
The iOS project requires a little setup for use VoIP notifications. Here you can find a description of how the project should be configured.
In order to get your device push token, you must listen for the KaleyraVideo.events.iOSVoipPushTokenUpdated event registering a callback as follows:
// The token is received in this listener only after calling kaleyraVideo.connect(_)
kaleyraVideo.on(KaleyraVideo.events.iOSVoipPushTokenUpdated, function (token) {
// register the VoIP push token on your server
});
Warning: Make sure this listener is attached before calling kaleyraVideo.connect(_), otherwise the event reporting the device token could be missed.
The token provided in the callback is the string representation of your device token. Here's an example of a device token: dec105f879924349fd2fa9aa8bb8b70431d5f41d57bfa8e31a5d80a629774fd9
Here you can find an example of how your VoIP notifications payload should be structured.
To connect the plugin to the Kaleyra Video system you will need to provide a Session object. The session needs a userID and a function returning a promise with the access token for that user
[!IMPORTANT]
- The userID should aready exists in our service. Your backend needs to create it by invoking this api create_user
- The accessToken should be generated from your backend by invoking this api get_credentials. Be aware that it expires. The callback will be called multiple times every time a new token is needed to refresh the user session.
kaleyraVideo.connect({
userID: "usr_xxx",
accessTokenProvider: (userId) => new Promise((success, error) => {
// get token for user_xxx and invoke success or error depending on the result
success("jwt_xxx");
}),
});
To make a call you need to specify some params.
kaleyraVideo.startCall({
callees: ['usr_yyy','usr_zzz'], // an array of user ids of the users you want to call
callType: KaleyraVideo.callTypes.AUDIO_VIDEO, // AUDIO, AUDIO_UPGRADABLE or AUDIO_VIDEO - the type of the call you want to start
recordingType: KaleyraVideo.recordingTypes.NONE // NONE, MANUAL or AUTOMATIC
});
To make a chat you need to specify some params.
kaleyraVideo.startChat('usr_yyy');// the user_id of the user you want to create a chat with
This method will allow you to set your user details DB from which the sdk will read when needed to show the information.
Be sure to have this always up to date, otherwise if an incoming call is received and the user is missing in this set the user ids will be printed on the UI.
kaleyraVideo.addUsersDetails([
{userID: "usr_yyy", name: "User1Name", imageUrl: "https://www.example.com/user1image.png"},
{userID: "usr_zzz", name: "User2Name", imageUrl: "https://www.example.com/user1image.png"},
]);
This method will allow you to remove all the user info from the local app DB.
kaleyraVideo.removeUsersDetails();
kaleyraVideo.clearUserCache();
This method is useful for use-cases where you need to show a prompt and don't want it to be invalidated by the call going into pip. For example: if you wish to show fingerprint dialog you should first put the current call in background, execute the fingerprint validation and then put back the call in foreground.
kaleyraVideo.setDisplayModeForCurrentCall(CallDisplayMode.FOREGROUND); // FOREGROUND, FOREGROUND_PICTURE_IN_PICTURE or CallDisplayMode.BACKGROUND
The plugin supports on_call_incoming notification. You will need to set the voipHandlingStrategy and subscribe to iOSVoipPushTokenUpdated event to receive the voip token to use on your backend to notify the plugin.
The plugin supports only on_call_incoming and on_message_sent notification types
You may add the following configuration under platform android in your config.xml. This will add our default notification handling which requires payload and user_token keys to be defined.
<config-file parent="/manifest/application" target="app/src/main/AndroidManifest.xml">
<service android:name="com.kaleyra.video_hybrid_native_bridge.notifications.KaleyraVideoNotificationService" android:enabled="true" android:exported="false" android:permission="android.permission.BIND_JOB_SERVICE">
<intent-filter>
<action android:name="com.kaleyra.VideoNotificationEvent" />
<!--//////// PATH to the object containing the payload, and user_token /////////-->
<data android:path="message.kaleyra" />
</intent-filter>
</service>
</config-file>
Example of acceptable payload
{
"google.delivered_priority":"high",
"content-available":"1",
"google.sent_time":1663347601917,
"google.ttl":60,
"google.original_priority":"high",
"from":"320",
"title":"",
"google.message_id":"0:1123%ac212d7bf9fd7ecd",
"message":"{\"kaleyra\":{\"payload\":{\"event\":\"on_call_incoming\",\"room_id\":\"room_b36f162\",\"data\":{\"initiator\":\"user1\",\"users\":[{\"user\":{\"userAlias\":\"user2\"},\"status\":\"invited\"},{\"user\":{\"userAlias\":\"user1\"},\"status\":\"invited\"}],\"roomAlias\":\"room_b37a64c6f162\",\"options\":{\"duration\":0,\"record\":true,\"recordingType\":\"manual\",\"recording\":\"manual\",\"creationDate\":\"2022-09-16T17:00:01.457Z\",\"callType\":\"audio_upgradable\",\"live\":true}}},\"user_token\":\"eyJhtokenksadfjoiasdjfoaidjfsoasidjfoi\"}}",
"google.c.sender.id":"320"
}
# Bandyer now Kaleyra proprietary SDK
-keep class com.bandyer.** { *; }
-keep interface com.bandyer.** { *; }
-keep enum com.bandyer.** { *; }
-keep class com.kaleyra.** { *; }
-keep interface com.kaleyra.** { *; }
-keep enum com.kaleyra.** { *; }
The API documentation is available on the github pages link: https://kaleyravideo.github.io/VideoCordovaPlugin