By Pierre-Yves Orban and Neeraj Tuteja
##Caution## If you are going to use both telephony sms plugin from the parent repository and this data sms plugin, then you need to rename files, Java classes and Javascript functions to avoid name conflicts.
##Description## This Android Phonegap plugin allows you to receive incoming data SMS on non-default port. You have the possibility to stop the message broadcasting and, thus, avoid theincoming message native popup.
Data SMS or SMS received on non-default port on a smartphone doesn't normally go to the native message application. So, it has to be received through the data sms intent. In case of non-smartphone like Symbian phone, data SMS gets converted to telephony SMS, thereby enabling the native message application to receive the message.
##Devices tested## This plugin was successfully tested with Cordova 3.5 and Android 4.4.2 (on a Samsung Note 3 device). Originally this plugin was tested with Phonegap 2.5 and Android 4.2.2 (on a Samsung Nexus device).
-
(Make sure you are using Cordova > 3.5, but earlier versions should work too)
-
Run command
cordova plugin add https://github.com/kant2002/Cordova-SMS-Reception-Plugin
Check if the SMS technology is supported by the device.
Example:
smsInboxPlugin.isSupported ((function(supported) {
if(supported)
alert("SMS supported !");
else
alert("SMS not supported");
}), function() {
alert("Error while checking the SMS support");
});
Start the SMS receiver waiting for incoming message The success callback function will be called everytime a new message is received. The given parameter is the received message formatted such as: phoneNumber>message (Exemple: +32472345678>Hello World) The error callback is called if an error occurs.
Example:
smsInboxPlugin.startReception (function(msg) {
alert(msg);
}, function() {
alert("Error while receiving messages");
});
Stop the SMS receiver
Example:
smsInboxPlugin.stopReception (function() {
alert("Correctly stopped");
}, function() {
alert("Error while stopping the SMS receiver");
});
If you abort the broadcast using this plugin (by setting the broadcast variable to true in the SmsReceiver), the SMS will not be broadcast to other applications like the native SMS app. So ... be careful !
A good way to manage this is to stop the sms reception when the onPause event is fired and, when the onResume event is fired, restart the reception.
The MIT License
Copyright (c) 2013 Pierre-Yves Orban
Copyright (c) 2014 Neeraj Tuteja
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.