This library enables full screen incoming call notifications on Android , leveraging Android's time-sensitive notifications. For more information, refer to the official (https://developer.android.com/training/notify-user/time-sensitive).
Starting from Android 12, the incoming call notification UI will resemble the one depicted here: https://developer.android.com/develop/ui/views/notifications/call-style
Provides full screen incoming call notifications for React Native applications on Android.
Ensure you are using the appropriate library version for your React Native version.
| Library Version | React Native Version |
|---|---|
react-native-full-screen-notification-incoming-call >= 0.1.8 |
>= 0.61.0 |
react-native-full-screen-notification-incoming-call <= 0.1.7 |
< 0.61.0 |
npm install react-native-full-screen-notification-incoming-call
In styles.xml:
<style name="incomingCall" parent="Theme.AppCompat.Light.NoActionBar">color
<!-- Customize status bar color -->
<item name="colorPrimaryDark">#000000</item>
</style>In AndroidManifest.xml:
// ...
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
<uses-permission android:name="android.permission.CALL_PHONE" />
<application ....>
<activity android:name="com.reactnativefullscreennotificationincomingcall.IncomingCallActivity"
android:theme="@style/incomingCall"
android:launchMode="singleTask"
android:excludeFromRecents="true"
android:exported="true"
android:showWhenLocked="true"
android:turnScreenOn="true"
/>
<activity android:name="com.reactnativefullscreennotificationincomingcall.NotificationReceiverActivity"
android:theme="@style/incomingCall"
android:launchMode="singleTask"
android:excludeFromRecents="true"
android:exported="true"
android:showWhenLocked="true"
android:turnScreenOn="true"
/>
<service
android:name="com.reactnativefullscreennotificationincomingcall.IncomingCallService"
android:enabled="true"
android:stopWithTask="false"
android:foregroundServiceType="phoneCall"
android:exported="true" />
.....
</application>import RNNotificationCall from 'react-native-full-screen-notification-incoming-call'; /**
* Display an incoming call notification
* @param uuid - Unique identifier for the call
* @param avatar - URL of the avatar image (optional)
* @param timeout - Timeout duration in milliseconds (optional)
* @param foregroundOptions - Options for the foreground notification
*/
function displayNotification(uid:string, avatar?:string, timeout?:number, foregroundOptions:ForegroundOptionsModel):void
/**
* Options for the foreground notification
*/
export interface ForegroundOptionsModel {
/** Channel ID of the notification */
channelId: string;
/** Channel name of the notification */
channelName: string;
/** Icon of the notification (mipmap) */
notificationIcon: string; //mipmap
/** Title of the notification */
notificationTitle: string;
/** Body of the notification */
notificationBody: string;
/** Label for the answer button */
answerText: string;
/** Label for the decline button */
declineText: string;
/** Color of the notification (optional) */
notificationColor?: string;
/** Sound of the notification (raw, optional) */
notificationSound?: string;
/** Main component name for custom incoming call screen (optional) */
mainComponent?: string;
/** Indicates if the call is a video call (default is false, optional) To understand the details you can check the [example](https://github.com/linhvovan29546/react-native-full-screen-notification-incoming-call/blob/master/example/index.tsx)*/
isVideo?: boolean;
/** Additional data (optional) */
payload?: any; //more info
}Example:
//example
RNNotificationCall.displayNotification(
'22221a97-8eb4-4ac2-b2cf-0a3c0b9100ad',
null,
30000,
{
channelId: 'com.abc.incomingcall',
channelName: 'Incoming video call',
notificationIcon: 'ic_launcher', //mipmap
notificationTitle: 'Linh Vo',
notificationBody: 'Incoming video call',
answerText: 'Answer',
declineText: 'Decline',
notificationColor: 'colorAccent',
isVideo:true,
notificationSound: null, //raw
//mainComponent:'MyReactNativeApp',//AppRegistry.registerComponent('MyReactNativeApp', () => CustomIncomingCall);
// payload:{name:'Test',Body:'test'}
}
);function hideNotification(): void;Example:
//example
RNNotificationCall.hideNotification();function addEventListener(eventName: 'answer',handler(payload:AnswerPayload): void): void;
export interface AnswerPayload {
callUUID: string; //call id
payload?: string; // jsonString
}Example:
//example
RNNotificationCall.addEventListener('answer', (data) => {
RNNotificationCall.backToApp();
const { callUUID, payload } = data;
console.log('press answer', callUUID);
});function addEventListener(eventName: 'endCall',handler(payload:DeclinePayload): void): void;
type DeclinePayload {
callUUID: string;// call id
payload?: string; // jsonString
endAction: 'ACTION_REJECTED_CALL' | 'ACTION_HIDE_CALL';
}
//ACTION_REJECTED_CALL => press button decline or call function declineCall
//ACTION_HIDE_CALL => action name when notification auto hide by timeoutExample:
// Example
RNNotificationCall.addEventListener('endCall', (data) => {
const { callUUID, endAction, payload } = data;
console.log('press endCall', callUUID);
});function removeEventListener(eventName: 'answer' | 'endCall'): void;Example:
// Example
RNNotificationCall.removeEventListener('answer');
RNNotificationCall.removeEventListener('endCall');function backToApp(): void;Example:
// Example
RNNotificationCall.backToApp();function declineCall(uuid: string, payload?: string): void;
// payload(optinal) : json stringExample:
// Example
RNNotificationCall.declineCall(22221a97-8eb4-4ac2-b2cf-0a3c0b9100ad, JSON.stringify({name:'Test',Body:'test'}));function answerCall(uuid: string, payload?: string): void;
// payload(optinal) : json stringExample:
// Example
RNNotificationCall.answerCall(22221a97-8eb4-4ac2-b2cf-0a3c0b9100ad, JSON.stringify({name:'Test',Body:'test'}));- [] Update the example to be simpler.
- [] Customize incoming call notification UI for Android versions below 12.
-
Custom Android notification sound:
- Since Android Oreo / 8 the Notification sound is coming from the Channel and can only be set the first time you add the channel via your channel.setSound(). If you want to change it later on you need to delete the channel and then re-add it to the system.
-
Android target 31 or higher: android.app.BackgroundServiceStartNotAllowedException: Not allowed to start service Intent (android.app.BackgroundServiceStartNotAllowedException: Not allowed to start service Intent) #38
-
On Android 13: Make sure enable notification permission relate #42
I love contributions! Check out my contributing docs to get more details into how to run this project, the examples, and more all locally.
To send a pull-request please follow these rules for naming the commit message. Based on the commit messages, increment the version from the latest release.
- If the string "
BREAKING CHANGE" is found anywhere in any of the commit messages or descriptions the major version will be incremented. - If a commit message begins with the string "
feat" then the minor version will be increased. "feat: new API". - All other changes will increment the
patch version.
Have an issue with using the runtime, or want to suggest a feature/API to help make your development life better? Log an issue in our issues tab! You can also browse older issues and discussion threads there to see solutions that may have worked for common problems.
MIT