am 3a0146cd: Merge "New API for "immersive" activity windows." into gingerbread

Merge commit '3a0146cd29fae3c5bc29d8d535d67826284f8cc9' into gingerbread-plus-aosp

* commit '3a0146cd29fae3c5bc29d8d535d67826284f8cc9':
  New API for "immersive" activity windows.

api/current.xml

@@ -188146,6 +188146,16 @@
  visibility="public"
 >
 </field>
+<field name="FLAG_IMMERSIVE"
+ type="int"
+ transient="false"
+ volatile="false"
+ value="8388608"
+ static="true"
+ final="true"
+ deprecated="not deprecated"
+ visibility="public"
+>
 </field>
 <field name="FLAG_KEEP_SCREEN_ON"
  type="int"

core/java/android/view/WindowManager.java

@@ -582,7 +582,20 @@ public interface WindowManager extends ViewManager {
          * seeing this window, unless {@link #FLAG_SHOW_WHEN_LOCKED} has
          * also been set. */
         public static final int FLAG_DISMISS_KEYGUARD = 0x00400000;
-        
+
+        /** Window flag: This window corresponds to an immersive activity
+         * that wishes not to be interrupted with notifications.  In general,
+         * applications may simply hide the status bar with {@link
+         * FLAG_FULLSCREEN} to suppress most notifications, but will still be
+         * interrupted by those with
+         * {@link android.app.Notification.fullScreenIntent} set (example: an
+         * incoming call).  Setting {@link FLAG_IMMERSIVE} will suppress the
+         * full-screen intent and show the status bar briefly for those
+         * important notifications instead.  See also
+         * {@link android.app.Notification.FLAG_HIGH_PRIORITY}.
+         */
+        public static final int FLAG_IMMERSIVE = 0x00800000;
+
         /** Window flag: *sigh* The lock screen wants to continue running its
          * animation while it is fading.  A kind-of hack to allow this.  Maybe
          * in the future we just make this the default behavior.