React Native Call Detection 🎉 🎊

This package helps to detect different call states like Incoming, Disconnected, Dialing and Connected for iOS. For android, this package will give following states, Offhook, Incoming, Disconnected and Missed. In the case of Incoming for android, the package will also provide with the incoming phone number.

Installation

Add the package to your react-native project in the following way

1yarn add react-native-call-detection
2

Link the current package to your react native project

1react-native link react-native-call-detection
2

For Android:-

Just Verify that the following changes are present in the corresponding files

• In MainApplication.java

1+ import com.pritesh.calldetection.CallDetectionManager;
2	@Override
3    protected List<ReactPackage> getPackages() {
4      return Arrays.<ReactPackage>asList(
5          new MainReactPackage(),
6+     new CallDetectionManager(MainApplication.this)
7      );
8    }
9  };

• In android/settings.gradle:

1...
2include ':app'
3+ include ':react-native-call-detection'
4+ project(':react-native-call-detection').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-call-detection/android')

• In android/app/build.gradle:

1dependencies {
2    ...
3    compile "com.facebook.react:react-native:+"  // From node_modules
4+   compile project(':react-native-call-detection')
5}

Usage

There are different hooks that you may get depending on the platform. Since for android you could also request the package to provide you with phone number of the caller, you will have to provide the necessary request message and the corresponding error callback. The package will request for READ_PHONE_STATE permission in android.

Its really easy to setup the package. Have a look at the following code snippet

1import CallDetectorManager from 'react-native-call-detection'
2
3startListenerTapped() {
4	this.callDetector = new CallDetectorManager((event)=> {
5	// For iOS event will be either "Connected",
6	// "Disconnected","Dialing" and "Incoming"
7	
8	// For Android event will be either "Offhook",
9	// "Disconnected", "Incoming" or "Missed"
10	
11
12	if (event === 'Disconnected') {
13	// Do something call got disconnected
14	} 
15	else if (event === 'Connected') {
16	// Do something call got connected
17	// This clause will only be executed for iOS
18	} 
19	else if (event === 'Incoming') {
20	// Do something call got incoming
21	}
22	else if (event === 'Dialing') {
23	// Do something call got dialing
24	// This clause will only be executed for iOS
25	} 
26	else if (event === 'Offhook') {
27	//Device call state: Off-hook. 
28	// At least one call exists that is dialing,
29	// active, or on hold, 
30	// and no calls are ringing or waiting.
31	// This clause will only be executed for Android
32	}
33	else if (event === 'Missed') {
34    	// Do something call got missed
35    	// This clause will only be executed for Android
36    }
37},
38false, // if you want to read the phone number of the incoming call [ANDROID], otherwise false
39()=>{}, // callback if your permission got denied [ANDROID] [only if you want to read incoming number] default: console.error
40{
41title: 'Phone State Permission',
42message: 'This app needs access to your phone state in order to react and/or to adapt to incoming calls.'
43} // a custom permission request message to explain to your user, why you need the permission [recommended] - this is the default one
44)
45}
46
47stopListenerTapped() {
48	this.callDetector && this.callDetector.dispose();
49}
50

Dont forget to call dispose when you don't intend to use call detection, as it will avoid memory leakages.

Example project can be used to test out the package. In the example project update the HomeComponent.js with the phone number to call

1  callFriendTapped() {
2  // Add the telephone num to call
3    Linking.openURL('tel:5555555555')
4      .catch(err => {
5        console.log(err)
6      });
7  }

How to run an example

1. Install node and watchman

   brew install node
   brew install watchman
    
   

2. yarn

   Install yarn from npm.

    npm i -g yarn
   

3. Xcode

   Install it from the App Store.

4. React Native Debugger

   This is an electron app that bundles react devtools, redux devtools and chrome devtools configured for use with react-native.

    brew cask install react-native-debugger
   

5. Once you have done all the above steps, navigate to CallDetectionExample folder and run yarn or npm install, it will fetch all the dependencies in the node_modules folder.

6. Run the packager npm start

7. Update the mobile number of your friend in HomeComponent.js

   1 callFriendTapped() {
   2 // Add the telephone number
   3	Linking.openURL('tel:5555555555')
   4  .catch(err => {
   5    console.log(err)
   6  });
   7 }
   8

8. To run the example on iOS from terminal type react-native run-ios (This will open the simulator, since simulator doesnt have the support for calling I will advice you to connect your iOS device and the follow the below procedure for running the app through xcode)

   or you can also run the app from xcode, for that, open /CallDectionExample/ios/CallDetectionExample.xcodeproj in xcode and run on the device.

9. To run the example on android, connect any android device to your mac then follow the below steps

   1. Navigate to android folder(./CallDectionExample/android/) folder and then run adb reverse tcp:8081 tcp:8081
   2. Navigate back to example directory(CallDectionExample) and then run react-native run-android

For any problems and doubt raise an issue.