CordovaSMS v0.0.3

Android SMS Cordova plugin

This plugin is designed for supporting Send & Receive SMS on Cordova based Android apps.

Since Android 4.4+, the Android requires app to be a default SMS app to send and receive SMS, else the sending should silently failed without issues. This Plugin is made to set your Cordova app as default SMS app and give your HTML and Javascript to send and receive SMSs

Installation

cordova plugin add CordovaSMS

Usage

To Check your App is default SMS App

CordovaSMS.checkDefault(function(s){
          console.log(s)
        }, 
        function(){});

//will respond {"thisApp":"com.yourapp.packagename","currentDefault":"com.android.mms"}
//thisApp - Package name of your app
//currentDefault - Current SMS app of the Android

To Set your App as default SMS App

CordovaSMS.setDefault(null,null,"com.yourapp.packagename");

//User will be prompt by Android system dialog to change the SMS app, the yes|no button click can be listen trough

CordovaSMS.onDefaultSelected(function(result){
                    //result value will be true if user hits Yes button, else it will result to false.
              });

To Receive SMS

  CordovaSMS.onSMS(function(sms){
    alert('Message is '+JSON.stringify(sms));
  });

To Send SMS

  var message = "SMS TEXT to Send";
  var receiver = "Receiver's Mobile number";
  CordovaSMS.sendSMS(receiver,message,successCallback,errorCallback});

  //May receive error on errorCallback if your app was not set as default SMS app by the user. You can change your app as default SMS app by calling setDefault, also call onDefaultSelected to listen user hitting yes or no.

Note: To send SMS your app should be default SMS app, you can use checkDefault and setDefault to make your app as default SMS app.

License

Copyright (C) 2016 Ramkumar Murugadoss

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.