Onactivate, ondeactivate & onfailure callbacks

src/android/BackgroundMode.java

@@ -37,6 +37,11 @@ import android.util.Log;
 
 public class BackgroundMode extends CordovaPlugin {
 
+    // Event types for callbacks
+    private enum Event {
+        ACTIVATE, DEACTIVATE, FAILURE
+    }
+
     // Flag indicates if the app is in background or foreground
     private boolean inBackground = false;
 
@@ -55,12 +60,11 @@ public class BackgroundMode extends CordovaPlugin {
         @Override
         public void onServiceConnected(ComponentName name, IBinder binder) {
             // Nothing to do here
-            Log.d("BackgroundMode", "Service connected");
         }
 
         @Override
         public void onServiceDisconnected(ComponentName name) {
-            Log.w("BackgroundMode", "Service disrupted");
+            // Nothing to do here
         }
     };
 
@@ -79,7 +83,7 @@ public class BackgroundMode extends CordovaPlugin {
      */
     @Override
     public boolean execute (String action, JSONArray args,
-            CallbackContext callback) throws JSONException {
+                            CallbackContext callback) throws JSONException {
 
         if (action.equalsIgnoreCase("configure")) {
             setSettings(args.getJSONObject(0));
@@ -188,10 +192,16 @@ public class BackgroundMode extends CordovaPlugin {
             return;
         }
 
-        context.bindService(
-                intent, connection, Context.BIND_AUTO_CREATE);
+        try {
+            context.bindService(
+                    intent, connection, Context.BIND_AUTO_CREATE);
 
-        context.startService(intent);
+            context.startService(intent);
+
+            fireEvent(Event.ACTIVATE, null);
+        } catch (Exception e) {
+            fireEvent(Event.FAILURE, e.getMessage());
+        }
 
         isBind = true;
     }
@@ -207,6 +217,7 @@ public class BackgroundMode extends CordovaPlugin {
                 context, ForegroundService.class);
 
         if (isBind) {
+            fireEvent(Event.DEACTIVATE, null);
             context.unbindService(connection);
         }
 
@@ -214,4 +225,32 @@ public class BackgroundMode extends CordovaPlugin {
 
         isBind = false;
     }
+
+    /**
+     * Fire vent with some parameters inside the web view.
+     *
+     * @param event
+     *      The name of the event
+     * @param params
+     *      Optional arguments for the event
+     */
+    private void fireEvent (Event event, String params) {
+        String eventName;
+
+        switch (event) {
+            case ACTIVATE:
+                eventName = "activate"; break;
+            case DEACTIVATE:
+                eventName = "deactivate"; break;
+            default:
+                eventName = "failure";
+
+        }
+
+        String js = String.format("setTimeout('cordova.plugins.backgroundMode" +
+                        ".on%s(%s)',0)",
+                eventName, params);
+
+        webView.loadUrl("javascript:" + js);
+    }
 }

src/ios/APPBackgroundMode.m

@@ -23,6 +23,11 @@
 
 @implementation APPBackgroundMode
 
+NSString *const kAPPBackgroundModeNamespace = @"cordova.plugins.backgroundMode";
+NSString *const kAPPBackgroundModeActivateEvent = @"activate";
+NSString *const kAPPBackgroundModeDeactivateEvent = @"deactivate";
+NSString *const kAPPBackgroundModeFailureEvent = @"failure";
+
 #pragma mark -
 #pragma mark Initialization methods
 
@@ -99,6 +104,7 @@
 - (void) keepAwake {
     if (enabled) {
         [audioPlayer play];
+        [self fireEvent:kAPPBackgroundModeActivateEvent withParams:NULL];
     }
 }
 
@@ -111,6 +117,10 @@
         NSLog(@"BackgroundMode: On simulator apps never pause in background!");
     }
 
+    if (audioPlayer.isPlaying) {
+        [self fireEvent:kAPPBackgroundModeDeactivateEvent withParams:NULL];
+    }
+
     [audioPlayer pause];
 }
 
@@ -149,11 +159,26 @@
     [session setActive:YES error:NULL];
 };
 
+#pragma mark -
+#pragma mark Helper methods
+
 /**
  * Restart playing sound when interrupted by phone calls.
  */
 - (void) handleAudioSessionInterruption:(NSNotification*)notification {
+    [self fireEvent:kAPPBackgroundModeDeactivateEvent withParams:NULL];
     [self keepAwake];
 }
 
+/**
+ * Method to fire an event with some parameters in the browser.
+ */
+- (void) fireEvent:(NSString*)event withParams:(NSString*)params
+{
+    NSString* js = [NSString stringWithFormat:@"setTimeout('%@.on%@(%@)',0)",
+                    kAPPBackgroundModeNamespace, event, params];
+
+    [self.commandDelegate evalJs:js];
+}
+
 @end

src/wp8/BackgroundMode.cs

@@ -21,6 +21,9 @@
 
 using WPCordovaClassLib.Cordova.Commands;
 using Windows.Devices.Geolocation;
+using Microsoft.Phone.Shell;
+using System;
+using WPCordovaClassLib.Cordova;
 
 namespace Cordova.Extension.Commands
 {
@@ -30,97 +33,167 @@ namespace Cordova.Extension.Commands
     public class BackgroundMode : BaseCommand
     {
         /// </summary>
-        /// Flag gibt an, ob die App im Hintergrund wach gehalten werden soll
+        /// Event types for callbacks
         /// </summary>
-        private static bool IsEnabled = true;
+        enum Event {
+            ACTIVATE, DEACTIVATE, FAILURE
+        }
+
+        #region Instance variables
 
         /// </summary>
-        /// Lokalisiert das Smartphone
+        /// Flag indicates if the plugin is enabled or disabled
+        /// </summary>
+        private bool IsDisabled = true;
+
+        /// </summary>
+        /// Geolocator to monitor location changes
         /// </summary>
         private static Geolocator Geolocator { get; set; }
 
-        /// </summary>
-        /// Registriert die Listener für die (sleep/resume) Events und startet
-        /// bzw. stoppt die Geo-Lokalisierung
-        /// </summary>
-        public BackgroundMode ()
-        {
-            Activate();
-        }
+        #endregion
+
+        #region Interface methods
 
         /// </summary>
-        /// @js-interface
-        /// Setzt den Flag, dass die App im Hintergrund wach gehalten werden soll
+        /// Enable the mode to stay awake when switching
+        /// to background for the next time.
         /// </summary>
         public void enable (string args)
         {
-            Enable();
+            IsDisabled = false;
         }
 
         /// </summary>
-        /// @js-interface
-        /// Entfernt den Flag, sodass die App im Hintergrund pausiert wird
+        /// Disable the background mode and stop
+        /// being active in background.
         /// </summary>
         public void disable (string args)
         {
-            Disable();
-        }
-
-        /// </summary>
-        /// Setzt den Flag, dass die App im Hintergrund wach gehalten werden soll
-        /// </summary>
-        public static void Enable ()
-        {
-            IsEnabled = true;
-        }
-
-        /// </summary>
-        /// Entfernt den Flag, sodass die App im Hintergrund pausiert wird
-        /// </summary>
-        public static void Disable ()
-        {
-            IsEnabled = false;
+            IsDisabled = true;
 
             Deactivate();
         }
 
-        /// </summary>
-        /// Startet das Aktualisieren des Standpunktes
-        /// </summary>
-        public static void Activate ()
-        {
-            if (Geolocator == null && IsEnabled && IsServiceAvailable())
-            {
-                Geolocator = new Geolocator();
+        #endregion
 
-                Geolocator.DesiredAccuracy   = PositionAccuracy.Default;
-                Geolocator.MovementThreshold = 100000;
-                Geolocator.PositionChanged  += geolocator_PositionChanged;
+        #region Core methods
+
+        /// </summary>
+        /// Keep the app awake by tracking
+        /// for position changes.
+        /// </summary>
+        private void Activate()
+        {
+            if (IsDisabled || Geolocator != null)
+                return;
+
+            if (!IsServiceAvailable())
+            {
+                FireEvent(Event.FAILURE, null);
+                return;
             }
+
+            Geolocator = new Geolocator();
+
+            Geolocator.DesiredAccuracy   = PositionAccuracy.Default;
+            Geolocator.MovementThreshold = 100000;
+            Geolocator.PositionChanged  += geolocator_PositionChanged;
+
+            FireEvent(Event.ACTIVATE, null);
         }
 
         /// </summary>
-        /// Beendet das Aktualisieren des Standpunktes
+        /// Let the app going to sleep.
         /// </summary>
-        public static void Deactivate ()
+        private void Deactivate ()
         {
-            if (Geolocator != null)
-            {
-                Geolocator.PositionChanged -= geolocator_PositionChanged;
-                Geolocator = null;
-            }
+            if (Geolocator == null)
+                return;
+
+            FireEvent(Event.DEACTIVATE, null);
+
+            Geolocator.PositionChanged -= geolocator_PositionChanged;
+            Geolocator = null;
         }
 
-        private static void geolocator_PositionChanged (Geolocator sender, PositionChangedEventArgs args) {}
+        #endregion
+
+        #region Helper methods
 
         /// </summary>
-        /// Gibt an, ob der Lokalisierungsdienst verfügbar ist
+        /// Determine if location service is available and enabled.
         /// </summary>
-        private static bool IsServiceAvailable()
+        private bool IsServiceAvailable()
         {
             Geolocator geolocator = (Geolocator == null) ? new Geolocator() : Geolocator;
 
-            return !(geolocator.LocationStatus == PositionStatus.Disabled || geolocator.LocationStatus == PositionStatus.NotAvailable);
+            PositionStatus status = geolocator.LocationStatus;
+
+            if (status == PositionStatus.Disabled)
+                return false;
+
+            if (status == PositionStatus.NotAvailable)
+                return false;
+
+            return true;
         }
+
+        /// <summary>
+        /// Fires the given event.
+        /// </summary>
+        private void FireEvent(Event Event, string Param)
+        {
+            string EventName;
+
+            switch (Event) {
+                case Event.ACTIVATE:
+                    EventName = "activate"; break;
+                case Event.DEACTIVATE:
+                    EventName = "deactivate"; break;
+                default:
+                    EventName = "failure"; break;
+            }
+
+            string js = String.Format("cordova.plugins.backgroundMode.on{0}({1})", EventName, Param);
+
+            PluginResult pluginResult = new PluginResult(PluginResult.Status.OK, js);
+
+            pluginResult.KeepCallback = true;
+
+            DispatchCommandResult(pluginResult);
+        }
+
+        #endregion
+
+        #region Delegate methods
+
+        private void geolocator_PositionChanged(Geolocator sender, PositionChangedEventArgs args)
+        {
+            // Nothing to do here
+        }
+
+        #endregion
+
+        #region Lifecycle methods
+
+        /// <summary>
+        /// Occurs when the application is being deactivated.
+        /// </summary>
+        public override void OnPause(object sender, DeactivatedEventArgs e)
+        {
+            Activate();
+        }
+
+        /// <summary>
+        /// Occurs when the application is being made active after previously being put
+        /// into a dormant state or tombstoned.
+        /// </summary>
+        public override void OnResume(object sender, ActivatedEventArgs e)
+        {
+            Deactivate();
+        }
+
+        #endregion
     }
 }