Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 303c07cc authored by Sreevani Sreejith's avatar Sreevani Sreejith Committed by android-build-merger
Browse files

Merge \\\\"Documented how to handle advertisements during audio playback.\\\\"... 

Merge \\\\"Documented how to handle advertisements during audio playback.\\\\" into mnc-io-docs am: 07340a65 am: 5fef4a7d am: 41a7bdec
am: 09bfc29d

Change-Id: I56d8dd1efe3d2e721501898691fd41923131239c
parents 0fcea07e 09bfc29d

docs/html/training/auto/audio/index.jd

+29 −1
Original line number Original line Diff line number Diff line
@@ -21,6 +21,7 @@ page.image=auto/images/assets/icons/media_app_playback.png 
      <li><a href="#config_manifest">Configure Your Manifest</a></li>

      <li><a href="#config_manifest">Configure Your Manifest</a></li>

      <li><a href="#isconnected">Determine if Your App is Connected</a></li>

      <li><a href="#isconnected">Determine if Your App is Connected</a></li>

      <li><a href="#alarm">Handle Alarms</a></li>

      <li><a href="#alarm">Handle Alarms</a></li>

      <li><a href="#mediaadv">Handle Media Advertisements</a></li>

      <li><a href="#implement_browser">Build a Browser Service</a></li>

      <li><a href="#implement_browser">Build a Browser Service</a></li>

      <li><a href="#implement_callback">Implement Play Controls</a></li>

      <li><a href="#implement_callback">Implement Play Controls</a></li>

      <li><a href="#support_voice">Support Voice Actions</a></li>

      <li><a href="#support_voice">Support Voice Actions</a></li>
@@ -261,7 +262,7 @@ following things: 
<ul>

<ul>

<li>Disable the alarm.</li>

<li>Disable the alarm.</li>

<li>Play the alarm over

<li>Play the alarm over

<a href="{@docRoot}reference/android/media/AudioManager.html">STREAM_ALARM</a>,

<a href="{@docRoot}reference/android/media/AudioManager.html#STREAM_ALARM">STREAM_ALARM</a>,

 and provide a UI on the phone screen to disable the alarm.</li>

 and provide a UI on the phone screen to disable the alarm.</li>

</ul>

</ul>
@@ -279,6 +280,33 @@ The following code snippet checks whether an app is running in car mode: 
  }

  }

</pre>

</pre>





<h2 id="mediaadv">Handle Media Advertisements</h2>

<p>By default, Android Auto displays a notification when

the media metadata changes during an audio playback session. When a media

app switches from playing music to running an advertisement, it is distracting

(and unnecessary) to display a notification to the user. To prevent Android Auto

from displaying a notification in this case, you must set the media metadata

key {@code android.media.metadata.ADVERTISEMENT} to 1, as shown in the code

snippet below:



<pre>



&#64;Override

public static final String EXTRA_METADATA_ADVERTISEMENT =

            "android.media.metadata.ADVERTISEMENT";



public void onPlayFromMediaId(String mediaId, Bundle extras) {

    MediaMetadata.Builder builder = new MediaMetadata.Builder();

    // ...

    if (isAd(mediaId)) {

        builder.putLong(EXTRA_METADATA_ADVERTISEMENT, 1);

    }

    // ...

    mediaSession.setMetadata(builder.build());

}



</pre>



<h2 id="implement_browser">Build a Browser Service</h2>

<h2 id="implement_browser">Build a Browser Service</h2>





<p>Auto devices interact with your app by contacting its implementation of a

<p>Auto devices interact with your app by contacting its implementation of a