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

Browse Source 
am: 07340a654a

Change-Id: I58c4cb8ec6d86a1bb1464a4fedd14ff21ab3a863
This commit is contained in:
sreevanis
2016-06-21 11:50:22 +00:00
committed by android-build-merger
parent d5af0a1214 07340a654a
commit 5fef4a7d44
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="#isconnected">Determine if Your App is Connected</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_callback">Implement Play Controls</a></li>
<li><a href="#support_voice">Support Voice Actions</a></li>
@@ -261,7 +262,7 @@ following things:
<ul>
<li>Disable the alarm.</li>
<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>
</ul>
@@ -279,6 +280,33 @@ The following code snippet checks whether an app is running in car mode:
}
</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>
<p>Auto devices interact with your app by contacting its implementation of a