Merge "Take snapshot when screen is turning off" into oc-dev am: 64900ad13c

am: 8947e7a215

Change-Id: Ifec8c2e6368e01e47ae2fdf6fecded4a7aa9172e

core/java/android/view/WindowManagerPolicy.java

@@ -589,6 +589,13 @@ public interface WindowManagerPolicy {
          * Notifies window manager that {@link #isKeyguardTrustedLw} has changed.
          */
         void notifyKeyguardTrustedChanged();
+
+        /**
+         * Notifies the window manager that screen is being turned off.
+         *
+         * @param listener callback to call when display can be turned off
+         */
+        void screenTurningOff(ScreenOffListener listener);
     }
 
     public interface PointerEventListener {
@@ -1266,6 +1273,15 @@ public interface WindowManagerPolicy {
      */
     public void screenTurnedOn();
 
+    /**
+     * Called when the display would like to be turned off. This gives policy a chance to do some
+     * things before the display power state is actually changed to off.
+     *
+     * @param screenOffListener Must be called to tell that the display power state can actually be
+     *                          changed now after policy has done its work.
+     */
+    public void screenTurningOff(ScreenOffListener screenOffListener);
+
     /**
      * Called when the device has turned the screen off.
      */
@@ -1275,6 +1291,13 @@ public interface WindowManagerPolicy {
         void onScreenOn();
     }
 
+    /**
+     * See {@link #screenTurnedOff}
+     */
+    public interface ScreenOffListener {
+        void onScreenOff();
+    }
+
     /**
      * Return whether the default display is on and not blocked by a black surface.
      */