Merge \\\\\"Documented how to handle advertisements during audio... (104af9a7) · Commits · e / os / android_frameworks_base

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

+29 −1

Original line number	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="#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>

		@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