react-native-immediate-phone-call

Initiate immediate phone call (without further user interaction) for React Native on iOS and Android.

The difference with react-native-phone-call and react-native-communications is that with this library no additional user input is required for Android and the call starts instantly (Apple always asks confirmation since the last iOs updates...).

NOTICE:

• for React Native < 0.47 use react-native-immediate-phone-call <1.x.x
• for React Native 0.47 - 0.59 use react-native-immediate-phone-call >=1.x.x
• for React Native >= 0.60 use react-native-immediate-phone-call >=2.x.x

Setup

(NOTICE THAT INSTALLATION STEPS FOR NEWER REACT NATIVE VERSIONS MAY BE DIFFERENT...)

For expo managed projects skip to expo setup guide

Fast and easy:

npm install react-native-immediate-phone-call --save

Add to your project automatically

react-native link react-native-immediate-phone-call

Or manual: add the latest version as dependency to your package.json.

{
  "name": "YourProject",
  ...
  },
  "dependencies": {
    ...
    "react-native-immediate-phone-call": "^1.0.0",
    ...
  }

iOS

• Add RNImmediatePhoneCall.xcoderproj into your project in the Libraries folder.
• Add the .a file on the General tab of your target under Linked Frameworks And Libraries.
• Add the .a file on the Build Phases tab of your target under Link Binary With Libraries.
• For iOS 9.0 and above it's mandatory to have LSApplicationQueriesSchemes in info.plist after </dict>

  <key>LSApplicationQueriesSchemes</key>
    <array>
        <string>tel</string>
        <string>telprompt</string>
    </array>

Android

• In the AndroidManifest.xml file of your android studio project add:

  <uses-permission android:name="android.permission.CALL_PHONE" />

• In the settings.gradle

    include ':react-native-immediate-phone-call', ':app'
    project(':react-native-immediate-phone-call').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-immediate-phone-call/android')

• In the app/build.gradle

    implementation project(':react-native-immediate-phone-call')

• In MainApplication.java

    import com.github.wumke.RNImmediatePhoneCall.RNImmediatePhoneCallPackage;
    ...
    @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
        ...
        new RNImmediatePhoneCallPackage(),
        ...
      );
    }
    ...

• MainActivity.java

    import com.github.wumke.RNImmediatePhoneCall.RNImmediatePhoneCallPackage;  // <--- import
    ...
    public class MainActivity extends ReactActivity {
      ...
      @Override
      public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
          RNImmediatePhoneCallPackage.onRequestPermissionsResult(requestCode, permissions, grantResults); // very important event callback
          super.onRequestPermissionsResult(requestCode, permissions, grantResults);
      }
      ...
    }

Setup in Expo

Install package

npm install react-native-immediate-phone-call --save

In the app.json file of your expo project add:

...
       "permissions": [
        ...
        "android.permission.CALL_PHONE"   // <--- add to your project permissions
      ],
...

Note: React-native-immediate-phone-call won't work in expo go and expo dev-client app, you'll need to build an actual apk to test it.

Usage

import RNImmediatePhoneCall from 'react-native-immediate-phone-call';
...
RNImmediatePhoneCall.immediatePhoneCall('0123456789');
...

Versioning

This project uses semantic versioning: MAJOR.MINOR.PATCH. This means that releases within the same MAJOR version are always backwards compatible. For more info see semver.org.