Detect screen status

www/background-mode.js

@@ -181,6 +181,21 @@ exports.overrideBackButton = function () {
     }, false);
 };
 
+/**
+ * If the screen is off.
+ *
+ * @param [ Function ] fn Callback function to invoke with boolean arg.
+ *
+ * @return [ Void ]
+ */
+exports.isScreenOff = function (fn) {
+    if (this._isAndroid) {
+        cordova.exec(fn, null, 'BackgroundMode', 'dimmed', []);
+    } else {
+        fn(undefined);
+    }
+};
+
 /**
  * If the mode is enabled or disabled.
  *