@ravinderz/react-native-expo-read-sms
v4.0.2
Published
Library to read incoming SMS in Android for Expo (React Native)
Downloads
4
Maintainers
Readme
This is a fork of @maniac-tech/react-native-expo-read-sms
react-native-expo-read-sms / Webpage
Installation
Install this in your managed Expo project by running this command:
$ npm install @ravinderz/react-native-expo-read-sms --save
Usage
Import the startReadSMS function after installation
import { startReadSMS } from "@ravinderz/react-native-expo-read-sms";
Pass Success and Error callbacks
startReadSMS(successCallbackFn, errorCallbackFn)
Everytime an SMS has been received
successCallbackFn
will be called with the sms
Example
You may refer to this sample application for how to use the library: GitHub Repo
Methods
| Method name | Description | Params | Returns |
| -------------------------- | ------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- |
| checkIfHasSMSPermission
| Function which checks if the application has READ_SMS
and RECEIVE_SMS
permissions | - | { hasReceiveSmsPermission: true/false, hasReadSmsPermission: true/false }
|
| requestReadSMSPermission
| Requests READ_SMS
and RECEIVE_SMS
permission, if missing | - | Returns true
if granted, and false
otherwise |
| startReadSMS
| Starts listening for incoming messages. Note: SMS Permissions should be present. | callback fn | Return a string with message orginating address, and message body. Example: [+919999999999, this is a sample message body]
|
Important Note:
Ensure your app has READ_SMS
, and RECEIVE_SMS
, failing which you'll receive error on calling the function
Support
Upgraded react version to latest.
License
MIT