Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge \\"Documented how to handle advertisements during audio playback.\\" into mnc-io-docs am: 07340a654a

Browse Source 
am: 5fef4a7d44

Change-Id: Ica1016e018fe5e278babd490b631414ad220f290
This commit is contained in:
Sreevani Sreejith
2016-06-21 11:55:54 +00:00
committed by android-build-merger
parent 9980514ee0 5fef4a7d44
commit 41a7bdec97
1 changed files with 29 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
docs/html/training/auto/audio/index.jd
View File

@@ -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