@clevertap/clevertap-signed-call-react-native

CleverTap Signed Call React Native SDK

👋 Introduction

The CleverTap's Signed Call React Native SDK provides an in-app calls service to make and receive calls in the mobile apps if the device has an internet connection and Signed Call React Native SDK.

To know more about the Signed Call feature, refer to Signed Call.

To get started, sign up here.

🚀 Install and Integration

• To add the CleverTap Signed Call React Native SDK to your project, run below command on terminal:

npm install @clevertap/clevertap-signed-call-react-native

• Now, in your TypeScript or JavaScript code, you can use:

import SignedCall from '@clevertap/clevertap-signed-call-react-native';

📑 Documentation & Example

• Checkout our Technical Documentation for instructions on integrating Signed Call into your React Native app.
• Checkout our Example React Native project.

🆕 Changelog

Refer to the Signed Call React Native SDK Change Log.

❓Questions

If you have questions or concerns, you can reach out to the CleverTap support team from the CleverTap Dashboard.

Changelog

Version 0.5.5 (June 24, 2024)

---

What's new

• [Android Platform]

  • Supports Signed Call Android SDK v0.0.5.5 which is compatible with CleverTap Android SDK v6.2.0.
  • Enables back button functionality across call screens (incoming, outgoing, and ongoing) to allow users to navigate to other parts of the application while staying on a call.
  • Adds new public API SignedCall.getBackToCall() to navigate the user to the active call.
  • Adds new public API SignedCall.getCallState() to retrieve the current call state.
  • Supports following new properties to the initProperties object which gets passed to the SignedCall.initialize(initProperties) method:
    • The notificationPermissionRequired of boolean type to make notification permission as optional during the Signed Call initialization on Android 13 and onwards.
    • The swipeOffBehaviourInForegroundService property of custom SCSwipeOffBehaviour enum type to define the swipe off behavior for an active call within the foreground service managed by host application. Please ensure to check the SDK documentation for detailed information on usage of initProperties listed above.
  • Introduces the following events to the SignedCall.SignedCallOnCallStatusChanged listener:
    • The CancelledDueToRingTimeout event which allows to handle the SDK-initiated cancellations due to ring-timeout. This event is reported when the SDK fails to establish communication with the receiver, often due to an offline device or a device with low bandwidth.
    • The DeclinedDueToBusyOnVoIP and DeclinedDueToBusyOnPSTN, to differentiate calls declined due to another Signed Call(VoIP) or declined due to a PSTN call respectively.
  • Exposes callId (call-specific identifier) parameter via CallDetails object provided in the result of the SignedCall.SignedCallOnCallStatusChanged listener.

• [iOS Platform]

  • Supports Signed Call iOS SDK v0.0.7 which is compatible with CleverTap iOS SDK v6.1.0.
  • Supports Socket.io v16.1.0 and Starscream v4.0.8 dependency.
  • Adds privacy manifest.
  • Expose socket usage logging for debugging purpose.

Behaviour Changes

• [Android Platform]

  • Adds heads up behaviour to the call-notifications to prompt the user every time the call-screen goes invisible, triggered by either a back button press or putting the app in the background. The heads up notifications allow users to return to the call interface by tapping on the notification.
  • Improved Bluetooth audio experience during calls. Dial tone of an outgoing call will now play through the connected Bluetooth headset instead of the internal speaker. Note: The SDK requires the runtime BLUETOOTH_CONNECT permission for Android 12 and onwards to enable the Bluetooth management during calls.

Bug Fixes

• [Android Platform]

  • Resolves an intermittent issue where the dialing tone at the initiator's side of the call plays on the loudspeaker instead of the internal speaker.
  • Resolves NPE crash occurring when calls are simultaneously initiated to each other, which disrupts the order of signals exchanged between participants.