From d3c609cbc143d10b8f13d01850949e08364584ce Mon Sep 17 00:00:00 2001 From: Hemal Patel Date: Fri, 22 Jul 2016 15:50:48 -0700 Subject: Docs: Used NotificationCompat.MediaStyle In the Controlling Media section, updated the overview and sample code to reference NotificationCompat.MediaStyle. Removed the note about the pre-requisite to have Android 5.0 and higher. Bug: 22505224 Change-Id: Id9a647ca8eec7f1b763227ee4fd1f18dee4bcb6f --- .../guide/topics/ui/notifiers/notifications.jd | 43 ++++++++++++---------- 1 file changed, 23 insertions(+), 20 deletions(-) diff --git a/docs/html/guide/topics/ui/notifiers/notifications.jd b/docs/html/guide/topics/ui/notifiers/notifications.jd index 6cd63f384a42..8c7e0864a2d9 100644 --- a/docs/html/guide/topics/ui/notifiers/notifications.jd +++ b/docs/html/guide/topics/ui/notifiers/notifications.jd @@ -886,35 +886,38 @@ method.

Controlling Media Playback on the Lock Screen

-

In Android 5.0 (API level 21) the lock screen no longer displays media controls -based on the {@link android.media.RemoteControlClient}, which is now deprecated. Instead, use the -{@link android.app.Notification.MediaStyle} template with the -{@link android.app.Notification.Builder#addAction(android.app.Notification.Action) addAction()} -method, which converts actions into clickable icons.

- -

Note: The template and the -{@link android.app.Notification.Builder#addAction(android.app.Notification.Action) addAction()} -method are not included in the support library, so these features run in Android 5.0 and higher -only.

- -

To display media playback controls on the lock screen in Android 5.0, set the visibility -to {@link android.support.v4.app.NotificationCompat#VISIBILITY_PUBLIC}, as described above. Then add -the actions and set the {@link android.app.Notification.MediaStyle} template, as described in the -following sample code:

+

+ In Android 5.0 (API level 21) the lock screen no longer displays media + controls based on the {@link android.media.RemoteControlClient}, which is + now deprecated. Instead, use the {@link + android.support.v7.app.NotificationCompat.MediaStyle} template with the + {@link + android.support.v4.app.NotificationCompat.Builder#addAction(android.support.v4.app.NotificationCompat.Action) + addAction()} method, which converts actions into clickable icons. +

+ +

+ To display media playback controls on the lock screen in Android 5.0, set + the visibility to {@link + android.support.v4.app.NotificationCompat#VISIBILITY_PUBLIC}, as described + above. Then add the actions and set the {@link + android.support.v7.app.NotificationCompat.MediaStyle} template, as described + in the following sample code: +

-Notification notification = new Notification.Builder(context)
+Notification notification = new NotificationCompat.Builder(context)
     // Show controls on lock screen even when user hides sensitive content.
-    .setVisibility(Notification.VISIBILITY_PUBLIC)
+    .setVisibility(NotificationCompat.VISIBILITY_PUBLIC)
     .setSmallIcon(R.drawable.ic_stat_player)
     // Add media control buttons that invoke intents in your media service
     .addAction(R.drawable.ic_prev, "Previous", prevPendingIntent) // #0
     .addAction(R.drawable.ic_pause, "Pause", pausePendingIntent)  // #1
     .addAction(R.drawable.ic_next, "Next", nextPendingIntent)     // #2
     // Apply the media style template
-    .setStyle(new Notification.MediaStyle()
-    .setShowActionsInCompactView(1 /* #1: pause button */)
-    .setMediaSession(mMediaSession.getSessionToken())
+    .setStyle(new NotificationCompat.MediaStyle()
+        .setShowActionsInCompactView(1 /* #1: pause button */)
+        .setMediaSession(mMediaSession.getSessionToken()))
     .setContentTitle("Wonderful music")
     .setContentText("My Awesome Band")
     .setLargeIcon(albumArtBitmap)
-- 
cgit v1.2.3-59-g8ed1b