react-native-call-detection
A React Native package to detect incoming, outgoing, and active call states on iOS and Android.
What is react-native-call-detection?
React Native Call Detection is a library that allows React Native apps to detect and respond to phone call events such as incoming, outgoing, and active calls. It solves the problem of apps needing to adapt their behavior—like pausing audio or logging call activities—when a user is engaged in a phone call, providing cross-platform support for iOS and Android with platform-specific call states.
React Native developers building apps that require telephony integration, such as audio players, call loggers, or applications that need to pause functionality during phone calls.
Developers choose this package because it offers a straightforward, well-documented API for call state detection across both major mobile platforms, handles Android permissions automatically, and includes memory management to prevent leaks, reducing the complexity of native telephony integration.
Overview
react-native package to detect call states
Use Cases
Best For
- Pausing background audio or media playback during phone calls
- Logging call events for analytics or user activity tracking
- Building call-blocking or call-screening applications
- Adapting app behavior based on call states (e.g., disabling notifications)
- Creating apps that require incoming caller ID display on Android
- Developing telephony-integrated productivity or safety apps
Not Ideal For
- Apps requiring incoming caller number detection on iOS (only available on Android)
- Projects needing identical call state events across iOS and Android (platform-specific differences exist)
- Teams wanting a drop-in solution without native configuration or Expo plugin setup
- Applications that require advanced telephony features like call blocking or programmatic call answering
Pros & Cons
Pros
Detects multiple call states on both iOS and Android, including incoming, disconnected, dialing, and connected for iOS, and offhook, incoming, disconnected, missed for Android, as detailed in the README usage examples.
Retrieves incoming call phone numbers on Android with automatic permission handling and customizable request messages, explicitly mentioned in the README for the 'Incoming' event.
Automatically requests READ_PHONE_STATE permission on Android and allows developers to set custom permission messages, simplifying compliance and user explanation, as shown in the constructor options.
Includes a dispose method to clean up listeners, with the README emphasizing its importance to avoid memory leakages in long-running apps.
Cons
Does not retrieve incoming call numbers on iOS, limiting caller ID features to Android only, which the README implicitly admits by only mentioning number retrieval for Android.
Event names and available states differ between iOS and Android (e.g., 'Connected' and 'Dialing' only on iOS, 'Offhook' and 'Missed' only on Android), requiring extra logic for cross-platform apps.
Running the example project involves multiple steps like installing external tools (node, watchman, Xcode) and device configuration, which can be cumbersome for quick testing, as outlined in the README's 'How to run an example' section.
Focuses solely on call state detection without built-in support for call handling, blocking, or other advanced operations, making it less suitable for full telephony apps beyond basic monitoring.
Frequently Asked Questions
Related Projects
detoxGray box end-to-end testing and automation framework for mobile apps
loki👁 Visual Regression Testing for Storybook
react-native-workersBackground services and web workers for react-native
react-native-network-loggerAn HTTP network request monitor for React Native with in-app interface for iOS and Android with no native code
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.