Class PlayerNotificationManager
- java.lang.Object
-
- com.google.android.exoplayer2.ui.PlayerNotificationManager
-
@Deprecated public class PlayerNotificationManager extends Object
Deprecated.com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.Starts, updates and cancels a media style notification reflecting the player state. The actions included in the notification can be customized along with their drawables, as described below.The notification is cancelled when
null
is passed tosetPlayer(Player)
or when the notification is dismissed by the user.If the player is released it must be removed from the manager by calling
setPlayer(null)
.Action customization
Playback actions can be included or omitted as follows:usePlayPauseActions
- Sets whether the play and pause actions are used.- Corresponding setter:
setUsePlayPauseActions(boolean)
- Default:
true
- Corresponding setter:
useRewindAction
- Sets whether the rewind action is used.- Corresponding setter:
setUseRewindAction(boolean)
- Default:
true
- Corresponding setter:
useRewindActionInCompactView
- IfuseRewindAction
istrue
, sets whether the rewind action is also used in compact view (including the lock screen notification). Else does nothing.- Corresponding setter:
setUseRewindActionInCompactView(boolean)
- Default:
false
- Corresponding setter:
useFastForwardAction
- Sets whether the fast forward action is used.- Corresponding setter:
setUseFastForwardAction(boolean)
- Default:
true
- Corresponding setter:
useFastForwardActionInCompactView
- IfuseFastForwardAction
istrue
, sets whether the fast forward action is also used in compact view (including the lock screen notification). Else does nothing.- Corresponding setter:
setUseFastForwardActionInCompactView(boolean)
- Default:
false
- Corresponding setter:
usePreviousAction
- Whether the previous action is used.- Corresponding setter:
setUsePreviousAction(boolean)
- Default:
true
- Corresponding setter:
usePreviousActionInCompactView
- IfusePreviousAction
istrue
, sets whether the previous action is also used in compact view (including the lock screen notification). Else does nothing.- Corresponding setter:
setUsePreviousActionInCompactView(boolean)
- Default:
false
- Corresponding setter:
useNextAction
- Whether the next action is used.- Corresponding setter:
setUseNextAction(boolean)
- Default:
true
- Corresponding setter:
useNextActionInCompactView
- IfuseNextAction
istrue
, sets whether the next action is also used in compact view (including the lock screen notification). Else does nothing.- Corresponding setter:
setUseNextActionInCompactView(boolean)
- Default:
false
- Corresponding setter:
useStopAction
- Sets whether the stop action is used.- Corresponding setter:
setUseStopAction(boolean)
- Default:
false
- Corresponding setter:
Overriding drawables
The drawables used by PlayerNotificationManager can be overridden by drawables with the same names defined in your application. The drawables that can be overridden are:exo_notification_small_icon
- The icon passed by default toNotificationCompat.Builder.setSmallIcon(int)
. A different icon can also be specified programmatically by callingsetSmallIcon(int)
.exo_notification_play
- The play icon.exo_notification_pause
- The pause icon.exo_notification_rewind
- The rewind icon.exo_notification_fastforward
- The fast forward icon.exo_notification_previous
- The previous icon.exo_notification_next
- The next icon.exo_notification_stop
- The stop icon.
Alternatively, the action icons can be set programatically by using the
PlayerNotificationManager.Builder
.Unlike the drawables above, the large icon (i.e. the icon passed to
NotificationCompat.Builder.setLargeIcon(Bitmap)
cannot be overridden in this way. Instead, the large icon is obtained from thePlayerNotificationManager.MediaDescriptionAdapter
passed toBuilder(Context, int, String, MediaDescriptionAdapter)
.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description class
PlayerNotificationManager.BitmapCallback
Deprecated.Receives aBitmap
.static class
PlayerNotificationManager.Builder
Deprecated.A builder forPlayerNotificationManager
instances.static interface
PlayerNotificationManager.CustomActionReceiver
Deprecated.Defines and handles custom actions.static interface
PlayerNotificationManager.MediaDescriptionAdapter
Deprecated.An adapter to provide content assets of the media currently playing.static interface
PlayerNotificationManager.NotificationListener
Deprecated.A listener for changes to the notification.static interface
PlayerNotificationManager.Priority
Deprecated.Priority of the notification (required for API 25 and lower).static interface
PlayerNotificationManager.Visibility
Deprecated.Visibility of notification on the lock screen.
-
Field Summary
Fields Modifier and Type Field Description static String
ACTION_FAST_FORWARD
Deprecated.The action which fast forwards.static String
ACTION_NEXT
Deprecated.The action which skips to the next media item.static String
ACTION_PAUSE
Deprecated.The action which pauses playback.static String
ACTION_PLAY
Deprecated.The action which starts playback.static String
ACTION_PREVIOUS
Deprecated.The action which skips to the previous media item.static String
ACTION_REWIND
Deprecated.The action which rewinds.static String
ACTION_STOP
Deprecated.The action which stops playback.static String
EXTRA_INSTANCE_ID
Deprecated.The extra key of the instance id of the player notification manager.
-
Constructor Summary
Constructors Modifier Constructor Description protected
PlayerNotificationManager(Context context, String channelId, int notificationId, PlayerNotificationManager.MediaDescriptionAdapter mediaDescriptionAdapter, PlayerNotificationManager.NotificationListener notificationListener, PlayerNotificationManager.CustomActionReceiver customActionReceiver, int smallIconResourceId, int playActionIconResourceId, int pauseActionIconResourceId, int stopActionIconResourceId, int rewindActionIconResourceId, int fastForwardActionIconResourceId, int previousActionIconResourceId, int nextActionIconResourceId, String groupKey)
Deprecated.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description protected androidx.core.app.NotificationCompat.Builder
createNotification(Player player, androidx.core.app.NotificationCompat.Builder builder, boolean ongoing, Bitmap largeIcon)
Deprecated.Creates the notification given the current player state.protected int[]
getActionIndicesForCompactView(List<String> actionNames, Player player)
Deprecated.Gets an array with the indices of the buttons to be shown in compact mode.protected List<String>
getActions(Player player)
Deprecated.Gets the names and order of the actions to be included in the notification at the current player state.protected boolean
getOngoing(Player player)
Deprecated.Returns whether the generated notification should be ongoing.void
invalidate()
Deprecated.Forces an update of the notification if already started.void
setBadgeIconType(int badgeIconType)
Deprecated.Sets the badge icon type of the notification.void
setColor(int color)
Deprecated.Sets the accent color of the notification.void
setColorized(boolean colorized)
Deprecated.Sets whether the notification should be colorized.void
setDefaults(int defaults)
Deprecated.Sets the defaults.void
setMediaSessionToken(android.support.v4.media.session.MediaSessionCompat.Token token)
Deprecated.Sets theMediaSessionCompat.Token
.void
setPlayer(Player player)
Deprecated.Sets thePlayer
.void
setPriority(@com.google.android.exoplayer2.ui.PlayerNotificationManager.Priority int priority)
Deprecated.Sets the priority of the notification required for API 25 and lower.void
setSmallIcon(int smallIconResourceId)
Deprecated.Sets the small icon of the notification which is also shown in the system status bar.void
setUseChronometer(boolean useChronometer)
Deprecated.Sets whether the elapsed time of the media playback should be displayed.void
setUseFastForwardAction(boolean useFastForwardAction)
Deprecated.Sets whether the fast forward action should be used.void
setUseFastForwardActionInCompactView(boolean useFastForwardActionInCompactView)
Deprecated.Sets whether the fast forward action should also be used in compact view.void
setUseNextAction(boolean useNextAction)
Deprecated.Sets whether the next action should be used.void
setUseNextActionInCompactView(boolean useNextActionInCompactView)
Deprecated.IfuseNextAction
istrue
, sets whether the next action should also be used in compact view.void
setUsePlayPauseActions(boolean usePlayPauseActions)
Deprecated.Sets whether the play and pause actions should be used.void
setUsePreviousAction(boolean usePreviousAction)
Deprecated.Sets whether the previous action should be used.void
setUsePreviousActionInCompactView(boolean usePreviousActionInCompactView)
Deprecated.IfusePreviousAction
istrue
, sets whether the previous action should also be used in compact view.void
setUseRewindAction(boolean useRewindAction)
Deprecated.Sets whether the rewind action should be used.void
setUseRewindActionInCompactView(boolean useRewindActionInCompactView)
Deprecated.Sets whether the rewind action should also be used in compact view.void
setUseStopAction(boolean useStopAction)
Deprecated.Sets whether the stop action should be used.void
setVisibility(@com.google.android.exoplayer2.ui.PlayerNotificationManager.Visibility int visibility)
Deprecated.Sets the visibility of the notification which determines whether and how the notification is shown when the device is in lock screen mode.
-
-
-
Field Detail
-
ACTION_PLAY
public static final String ACTION_PLAY
Deprecated.The action which starts playback.- See Also:
- Constant Field Values
-
ACTION_PAUSE
public static final String ACTION_PAUSE
Deprecated.The action which pauses playback.- See Also:
- Constant Field Values
-
ACTION_PREVIOUS
public static final String ACTION_PREVIOUS
Deprecated.The action which skips to the previous media item.- See Also:
- Constant Field Values
-
ACTION_NEXT
public static final String ACTION_NEXT
Deprecated.The action which skips to the next media item.- See Also:
- Constant Field Values
-
ACTION_FAST_FORWARD
public static final String ACTION_FAST_FORWARD
Deprecated.The action which fast forwards.- See Also:
- Constant Field Values
-
ACTION_REWIND
public static final String ACTION_REWIND
Deprecated.The action which rewinds.- See Also:
- Constant Field Values
-
ACTION_STOP
public static final String ACTION_STOP
Deprecated.The action which stops playback.- See Also:
- Constant Field Values
-
EXTRA_INSTANCE_ID
public static final String EXTRA_INSTANCE_ID
Deprecated.The extra key of the instance id of the player notification manager.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
PlayerNotificationManager
protected PlayerNotificationManager(Context context, String channelId, int notificationId, PlayerNotificationManager.MediaDescriptionAdapter mediaDescriptionAdapter, @Nullable PlayerNotificationManager.NotificationListener notificationListener, @Nullable PlayerNotificationManager.CustomActionReceiver customActionReceiver, int smallIconResourceId, int playActionIconResourceId, int pauseActionIconResourceId, int stopActionIconResourceId, int rewindActionIconResourceId, int fastForwardActionIconResourceId, int previousActionIconResourceId, int nextActionIconResourceId, @Nullable String groupKey)
Deprecated.
-
-
Method Detail
-
setPlayer
public final void setPlayer(@Nullable Player player)
Deprecated.Sets thePlayer
.Setting the player starts a notification immediately unless the player is in
Player.STATE_IDLE
, in which case the notification is started as soon as the player transitions away from being idle.If the player is released it must be removed from the manager by calling
setPlayer(null)
. This will cancel the notification.- Parameters:
player
- ThePlayer
to use, ornull
to remove the current player. Only players which are accessed on the main thread are supported (player.getApplicationLooper() == Looper.getMainLooper()
).
-
setUseNextAction
public final void setUseNextAction(boolean useNextAction)
Deprecated.Sets whether the next action should be used.- Parameters:
useNextAction
- Whether to use the next action.
-
setUsePreviousAction
public final void setUsePreviousAction(boolean usePreviousAction)
Deprecated.Sets whether the previous action should be used.- Parameters:
usePreviousAction
- Whether to use the previous action.
-
setUseNextActionInCompactView
public final void setUseNextActionInCompactView(boolean useNextActionInCompactView)
Deprecated.IfuseNextAction
istrue
, sets whether the next action should also be used in compact view. Has no effect ifuseNextAction
isfalse
.If set to
true
,setUseFastForwardActionInCompactView
is set to false.- Parameters:
useNextActionInCompactView
- Whether to use the next action in compact view.
-
setUsePreviousActionInCompactView
public final void setUsePreviousActionInCompactView(boolean usePreviousActionInCompactView)
Deprecated.IfusePreviousAction
istrue
, sets whether the previous action should also be used in compact view. Has no effect ifusePreviousAction
isfalse
.If set to
true
,setUseRewindActionInCompactView
is set to false.- Parameters:
usePreviousActionInCompactView
- Whether to use the previous action in compact view.
-
setUseFastForwardAction
public final void setUseFastForwardAction(boolean useFastForwardAction)
Deprecated.Sets whether the fast forward action should be used.- Parameters:
useFastForwardAction
- Whether to use the fast forward action.
-
setUseRewindAction
public final void setUseRewindAction(boolean useRewindAction)
Deprecated.Sets whether the rewind action should be used.- Parameters:
useRewindAction
- Whether to use the rewind action.
-
setUseFastForwardActionInCompactView
public final void setUseFastForwardActionInCompactView(boolean useFastForwardActionInCompactView)
Deprecated.Sets whether the fast forward action should also be used in compact view. Has no effect ifACTION_FAST_FORWARD
is not enabled, for instance if the media is not seekable.If set to
true
,setUseNextActionInCompactView
is set to false.- Parameters:
useFastForwardActionInCompactView
- Whether to use the fast forward action in compact view.
-
setUseRewindActionInCompactView
public final void setUseRewindActionInCompactView(boolean useRewindActionInCompactView)
Deprecated.Sets whether the rewind action should also be used in compact view. Has no effect ifACTION_REWIND
is not enabled, for instance if the media is not seekable.If set to
true
,setUsePreviousActionInCompactView
is set to false.- Parameters:
useRewindActionInCompactView
- Whether to use the rewind action in compact view.
-
setUsePlayPauseActions
public final void setUsePlayPauseActions(boolean usePlayPauseActions)
Deprecated.Sets whether the play and pause actions should be used.- Parameters:
usePlayPauseActions
- Whether to use play and pause actions.
-
setUseStopAction
public final void setUseStopAction(boolean useStopAction)
Deprecated.Sets whether the stop action should be used.- Parameters:
useStopAction
- Whether to use the stop action.
-
setMediaSessionToken
public final void setMediaSessionToken(android.support.v4.media.session.MediaSessionCompat.Token token)
Deprecated.Sets theMediaSessionCompat.Token
.- Parameters:
token
- TheMediaSessionCompat.Token
.
-
setBadgeIconType
public final void setBadgeIconType(int badgeIconType)
Deprecated.Sets the badge icon type of the notification.See
NotificationCompat.Builder.setBadgeIconType(int)
.- Parameters:
badgeIconType
- The badge icon type.
-
setColorized
public final void setColorized(boolean colorized)
Deprecated.Sets whether the notification should be colorized. When set, the color set withsetColor(int)
will be used as the background color for the notification.See
NotificationCompat.Builder.setColorized(boolean)
.- Parameters:
colorized
- Whether to colorize the notification.
-
setDefaults
public final void setDefaults(int defaults)
Deprecated.Sets the defaults.See
NotificationCompat.Builder.setDefaults(int)
.- Parameters:
defaults
- The default notification options.
-
setColor
public final void setColor(int color)
Deprecated.Sets the accent color of the notification.See
NotificationCompat.Builder.setColor(int)
.- Parameters:
color
- The color, in ARGB integer form like the constants inColor
.
-
setPriority
public final void setPriority(@com.google.android.exoplayer2.ui.PlayerNotificationManager.Priority int priority)
Deprecated.Sets the priority of the notification required for API 25 and lower.See
NotificationCompat.Builder.setPriority(int)
.To set the priority for API levels above 25, you can create your own
NotificationChannel
with a given importance level and pass the id of the channel toBuilder(Context, int, String, MediaDescriptionAdapter)
.- Parameters:
priority
- The priority which can be one ofNotificationCompat.PRIORITY_DEFAULT
,NotificationCompat.PRIORITY_MAX
,NotificationCompat.PRIORITY_HIGH
,NotificationCompat.PRIORITY_LOW
orNotificationCompat.PRIORITY_MIN
. If not setNotificationCompat.PRIORITY_LOW
is used by default.
-
setSmallIcon
public final void setSmallIcon(@DrawableRes int smallIconResourceId)
Deprecated.Sets the small icon of the notification which is also shown in the system status bar.See
NotificationCompat.Builder.setSmallIcon(int)
.- Parameters:
smallIconResourceId
- The resource id of the small icon.
-
setUseChronometer
public final void setUseChronometer(boolean useChronometer)
Deprecated.Sets whether the elapsed time of the media playback should be displayed.Note that this setting only works if all of the following are true:
- The media is
actively playing
. - The media is not
dynamically changing its duration
(like for example a live stream). - The media is not
interrupted by an ad
. - The media is played at
regular speed
. - The device is running at least API 21 (Lollipop).
See
NotificationCompat.Builder.setUsesChronometer(boolean)
.- Parameters:
useChronometer
- Whether to use chronometer.
- The media is
-
setVisibility
public final void setVisibility(@com.google.android.exoplayer2.ui.PlayerNotificationManager.Visibility int visibility)
Deprecated.Sets the visibility of the notification which determines whether and how the notification is shown when the device is in lock screen mode.See
NotificationCompat.Builder.setVisibility(int)
.- Parameters:
visibility
- The visibility which must be one ofNotificationCompat.VISIBILITY_PUBLIC
,NotificationCompat.VISIBILITY_PRIVATE
orNotificationCompat.VISIBILITY_SECRET
.
-
invalidate
public final void invalidate()
Deprecated.Forces an update of the notification if already started.
-
createNotification
@Nullable protected androidx.core.app.NotificationCompat.Builder createNotification(Player player, @Nullable androidx.core.app.NotificationCompat.Builder builder, boolean ongoing, @Nullable Bitmap largeIcon)
Deprecated.Creates the notification given the current player state.- Parameters:
player
- The player for which state to build a notification.builder
- The builder used to build the last notification, ornull
. Re-using the builder when possible can prevent notification flicker whenUtil#SDK_INT
< 21.ongoing
- Whether the notification should be ongoing.largeIcon
- The large icon to be used.- Returns:
- The
NotificationCompat.Builder
on which to callNotificationCompat.Builder.build()
to obtain the notification, ornull
if no notification should be displayed.
-
getActions
protected List<String> getActions(Player player)
Deprecated.Gets the names and order of the actions to be included in the notification at the current player state.The playback and custom actions are combined and placed in the following order if not omitted:
+------------------------------------------------------------------------+ | prev | << | play/pause | >> | next | custom actions | stop | +------------------------------------------------------------------------+
This method can be safely overridden. However, the names must be of the playback actions
ACTION_PAUSE
,ACTION_PLAY
,ACTION_FAST_FORWARD
,ACTION_REWIND
,ACTION_NEXT
orACTION_PREVIOUS
, or a key contained in the map returned byPlayerNotificationManager.CustomActionReceiver.createCustomActions(Context, int)
. Otherwise the action name is ignored.
-
getActionIndicesForCompactView
protected int[] getActionIndicesForCompactView(List<String> actionNames, Player player)
Deprecated.Gets an array with the indices of the buttons to be shown in compact mode.This method can be overridden. The indices must refer to the list of actions passed as the first parameter.
- Parameters:
actionNames
- The names of the actions included in the notification.player
- The player for which a notification is being built.
-
getOngoing
protected boolean getOngoing(Player player)
Deprecated.Returns whether the generated notification should be ongoing.
-
-