am ad0cab26: am fdb738a5: am 752d8029: Merge "Doc update: minor changes to...

<h2>This lesson teaches you to</h2>

<ol>

  <li><a href="#compare">Choose an Approach</a></li>

  <li><a href="#nonsticky">Use IMMERSIVE</a></li>

  <li><a href="#sticky">Use IMMERSIVE_STICKY</a></li>

  <li><a href="#nonsticky">Use Non-Sticky Immersion</a></li>

  <li><a href="#sticky">Use Sticky Immersion</a></li>

</ol>

shown in this mode are in a transient state.

</p>

 <p>When you use {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE IMMERSIVE} or

 {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY IMMERSIVE_STICKY},

 the system UI stays hidden, even while users are interacting with your

app or game. You can capture touch events from anywhere across the screen, even areas that

would otherwise be occupied by the system bars. This gives you a great way to create a

larger, richer, more <a href="{@docRoot}design/patterns/fullscreen.html">

immersive</a> UI in your app or game and reduce visual distraction at the same time.</p>

<p>Figure 1 illustrates the different "immersive mode" states:</p>

 <img src="{@docRoot}images/training/imm-states.png"

 <p>The flags  {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE} and

 {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY} both provide an immersive

 experience. But whereas the

 {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY IMMERSIVE_STICKY}

 flag causes semi-transparent system bars to briefly show and then hide again in response to

 a swipe gesture, the same swipe gesture causes the system bars to reappear and remain

 visible if you instead use the {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE IMMERSIVE}

 flag. Here are examples of when you would use one vs. the other:</p>

 experience, but with the differences in behavior described above. Here are

 examples of when you would use one flag vs. the other:</p>

<ul>

<li>If you're building a book reader, news reader, or a magazine, use

sufficient. Don't use the "immersive" flags in this case.</li>

</ul>

<h2 id="nonsticky">Use IMMERSIVE</h2>

<h2 id="nonsticky">Use Non-Sticky Immersion</h2>

 <p>When you use the {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE} flag, it hides

 the system bars based on what other UI flags you have set

<a class ="external-link" href="http://www.youtube.com/embed/cBi8fjv90E4">DevBytes:

 Android 4.4 Immersive Mode</a>.</p>

<h2 id="sticky">Use IMMERSIVE_STICKY</h2>

<h2 id="sticky">Use Sticky Immersion</h2>

<p>When you use the {@link android.view.View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY} flag,

an inward swipe in the system bars areas causes the bars to temporarily appear in a