Cordova plugin to enable single SMS reception in Android using the SMS Retriever API
npm install cordova-plugin-android-sms-retriever-apiCordova Plugin Android SMS Retriever API
========================================
Cordova plugin to enable single SMS reception in Android using the SMS Retriever API
in order to read automatically one-time passwords from SMS messages.
This plugin is intended to comply with the critical changes introduced by Google
in 2019 in SMS and CALL LOGS policies
and does not need extra permissions to work.
The installation requires cordova 6.0+.
Use the cordova client in order to install the package.
``bash`
$ cordova plugin add cordova-plugin-android-sms-retriever-api
The plugin requires the Google libraries com.google.android.gms:play-services-auth
and com.google.android.gms:play-services-auth-api-phone.
The default versions of this two libraries has been set to 15.+, but you can configure
the version you want by defining the PLAY_SERVICES_AUTH_VERSION and
PLAY_SERVICES_AUTH_API_PHONE_VERSION preferences in config.xml or package.json.
`xml`
To use the SMS Retriever API
you need to include a text signature in your SMS content. You can find more about
this topic in the Google Developers Guide
To start listening for a single incoming SMS with a verification code during 5 minutes use the following method.
`javascript`
cordova.plugins.smsRetriever.start(function() {
// Listener registered successfully
}, function(err) {
// Failed to register listener
console.error(err);
});
Calling the above method will only start listening for incoming SMS messages with
the application signature. In order to attach an event handler to the SMS received event
you will have to call the "on" method.
`javascript`
cordova.plugins.smsRetriever.on('smsReceived', function(smsMessage) {
// Sms received
console.error(smsMessage);
});
Starts listening for one single SMS message during 5 minutes.
#### Parameters
| Parameter | Type | Default | Description |
| ---------------- | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| successHandler | Function | | Is called when the plugin successfully starts listening number. |errorHandler
| | Function | | Is called when the plugin encounters an error while trying to start listening number. |
#### Example
`javascript`
cordova.plugins.smsRetriever.start(function() {
// Listener registered successfully
}, function(err) {
// Failed to register listener
console.error(err);
});
Stops listening for SMS messages
#### Parameters
| Parameter | Type | Default | Description |
| ---------------- | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| successHandler | Function | | Is called when the plugin successfully stops listening number. |errorHandler
| | Function | | Is called when the plugin encounters an error while trying to stop listening number. |
#### Example
`javascript`
cordova.plugins.smsRetriever.stop(function() {
// Listener registered successfully
}, function(err) {
// Failed to register listener
console.error(err);
});
Registers an event handler for the event name.
#### Parameters
| Parameter | Type | Default | Description |
| ---------- | ---------- | ------- | ------------------------------------------------------------------ |
| eventName | string | | Name of the event to listen to. See below for all the event names. |eventHandler
| | Function | | Is called when the event is triggered.
Fired when the listener receives an SMS message.
#### Callback parameters
| Parameter | Type | Description |
| ----------------------- | -------- | ------------------------------------------------------------------------------- |
| smsMessage | string | The complete received SMS message |
#### Example
`javascript`
cordova.plugins.smsRetriever.on('smsReceived', (smsMessage) => {
// Sms received
console.error('This is the content of the SMS message: ' + smsMessage);
});
Fired when the listener stops listening after 5 minutes from start.
Unregisters an event handler for the event name. If eventHandler is not defined, unregisters all events of the eventName.
#### Parameters
| Parameter | Type | Default | Description |
| ---------- | ---------- | ------- | ------------------------------------------------------------------ |
| eventName | string | | Name of the event to unregister. |eventHandler
| | Function | | The eventHandler to unregister. If not provided, all the events of the eventName will be unregistered |
#### Example
`javascript``
cordova.plugins.smsRetriever.off('smsReceived');
If you want to debug the SMS reception with Android Studio, remember to include
the same signing configuration as the one you have used to create the SMS text
signature in the app Module by right clicking in your project, chosing the
Open Module Settings option and selecting the app Module.
If you use the App signing by Google Play feature, the applications downloaded from Google
Play Store will have a different signature than the one used by you to sign the apk.
In this case, you will have to download the App signing certificate of the app
from the Google Play Console, use the certificate to create a .jks and use this file
to obtain the 11 characters signature that should be attached to the SMS.
Licensed under the BSD 3-Clause License. See LICENSE.txt for details.