MediaStyle

Kotlin |Java

open class MediaStyle : NotificationCompat.Style

kotlin.Any
↳	androidx.core.app.NotificationCompat.Style
	↳	androidx.media.app.NotificationCompat.MediaStyle

Known Direct Subclasses

NotificationCompat.DecoratedMediaCustomViewStyle

Notification style for media custom views that are decorated by the system.

Notification style for media playback notifications. In the expanded form, up to 5 actions specified with #addAction(int, CharSequence, PendingIntent) addAction will be shown as icon-only pushbuttons, suitable for transport controls. The Bitmap given to #setLargeIcon(android.graphics.Bitmap) setLargeIcon() will be treated as album artwork. Unlike the other styles provided here, MediaStyle can also modify the standard-size content view; by providing action indices to setShowActionsInCompactView(int...) you can promote up to 3 actions to be displayed in the standard view alongside the usual content. Notifications created with MediaStyle will have their category set to CATEGORY_TRANSPORT unless you set a different category using setCategory(). Finally, if you attach a MediaSession.Token using NotificationCompat.MediaStyle#setMediaSession, the System UI can identify this as a notification representing an active media session and respond accordingly (by showing album artwork in the lockscreen, for example). To use this style with your Notification, feed it to androidx.core.app.NotificationCompat.Builder#setStyle like so:

Notification noti = new NotificationCompat.Builder()
          .setSmallIcon(R.drawable.ic_stat_player)
          .setContentTitle("Track title")
          .setContentText("Artist - Album")
          .setLargeIcon(albumArtBitmap))
          .setStyle(<b>new NotificationCompat.MediaStyle()</b>.setMediaSession(mySession))
          .build();

Summary

Public constructors
`<init>()`
`<init>(builder: NotificationCompat.Builder!)`

Public methods
open static MediaSessionCompat.Token!	`getMediaSession(notification: Notification!)` Extracts a `MediaSessionCompat.Token` from the extra values in the `MediaStyle` `notification`.
open NotificationCompat.MediaStyle!	`setCancelButtonIntent(pendingIntent: PendingIntent!)` Sets the pending intent to be sent when the cancel button is pressed.
open NotificationCompat.MediaStyle!	`setMediaSession(token: MediaSessionCompat.Token!)` Attaches a `MediaSessionCompat.Token` to this Notification to provide additional playback information and control to the SystemUI.
open NotificationCompat.MediaStyle!	`setShowActionsInCompactView(vararg actions: Int)` Requests up to 3 actions (by index in the order of addition) to be shown in the compact notification view.
open NotificationCompat.MediaStyle!	`setShowCancelButton(show: Boolean)` Sets whether a cancel button at the top right should be shown in the notification on platforms before Lollipop.

Inherited functions

From class Style

Notification?

build()

If this Style object has been set on a notification builder, this method will build that notification and return it. Otherwise, it will return null.

Unit

setBuilder(@Nullable builder: NotificationCompat.Builder?)

Link this rich notification style with a notification builder.

Public constructors

<init>

MediaStyle()

<init>

MediaStyle(builder: NotificationCompat.Builder!)

Public methods

getMediaSession

open static fun getMediaSession(notification: Notification!): MediaSessionCompat.Token!

Extracts a MediaSessionCompat.Token from the extra values in the MediaStyle notification.

Parameters
`notification`	Notification!: The notification to extract a `MediaSessionCompat.Token` from.

Return
`MediaSessionCompat.Token!`	The `MediaSessionCompat.Token` in the `notification` if it contains, null otherwise.

setCancelButtonIntent

open fun setCancelButtonIntent(pendingIntent: PendingIntent!): NotificationCompat.MediaStyle!

Sets the pending intent to be sent when the cancel button is pressed. See .

Parameters
`pendingIntent`	PendingIntent!: the intent to be sent when the cancel button is pressed

setMediaSession

open fun setMediaSession(token: MediaSessionCompat.Token!): NotificationCompat.MediaStyle!

Attaches a MediaSessionCompat.Token to this Notification to provide additional playback information and control to the SystemUI.

setShowActionsInCompactView

open fun setShowActionsInCompactView(vararg actions: Int): NotificationCompat.MediaStyle!

Requests up to 3 actions (by index in the order of addition) to be shown in the compact notification view.

Parameters
`actions`	Int: the indices of the actions to show in the compact notification view

setShowCancelButton

open fun setShowCancelButton(show: Boolean): NotificationCompat.MediaStyle!

Sets whether a cancel button at the top right should be shown in the notification on platforms before Lollipop.

Prior to Lollipop, there was a bug in the framework which prevented the developer to make a notification dismissable again after having used the same notification as the ongoing notification for a foreground service. When the notification was posted by android.app.Service#startForeground, but then the service exited foreground mode via android.app.Service#stopForeground, without removing the notification, the notification stayed ongoing, and thus not dismissable.

This is a common scenario for media notifications, as this is exactly the service lifecycle that happens when playing/pausing media. Thus, a workaround is provided by the support library: Instead of making the notification ongoing depending on the playback state, the support library provides the ability to add an explicit cancel button to the notification.

Note that the notification is enforced to be ongoing if a cancel button is shown to provide a consistent user experience.

Also note that this method is a no-op when running on Lollipop and later.

Parameters
`show`	Boolean: whether to show a cancel button