MediaSessionCompat

public static final String ACTION_FLAG_AS_INAPPROPRIATE = "android.support.v4.media.session.action.FLAG_AS_INAPPROPRIATE"

Predefined custom action to flag the media that is currently playing as inappropriate.

public static final String ACTION_FOLLOW = "android.support.v4.media.session.action.FOLLOW"

Predefined custom action to follow an artist, album, or playlist. The extra bundle must have ARGUMENT_MEDIA_ATTRIBUTE to indicate the type of the follow action. The bundle can also have an optional string argument, ARGUMENT_MEDIA_ATTRIBUTE_VALUE, to specify the target to follow (e.g., the name of the artist to follow). If this argument is omitted, the currently playing media will be the target of the action. Thus, the session must perform the follow action with the current metadata. If there's no specified attribute in the current metadata, the controller must not omit this argument.

public static final String ACTION_SKIP_AD = "android.support.v4.media.session.action.SKIP_AD"

Predefined custom action to skip the advertisement that is currently playing.

public static final String ACTION_UNFOLLOW = "android.support.v4.media.session.action.UNFOLLOW"

Predefined custom action to unfollow an artist, album, or playlist. The extra bundle must have ARGUMENT_MEDIA_ATTRIBUTE to indicate the type of the unfollow action. The bundle can also have an optional string argument, ARGUMENT_MEDIA_ATTRIBUTE_VALUE, to specify the target to unfollow (e.g., the name of the artist to unfollow). If this argument is omitted, the currently playing media will be the target of the action. Thus, the session must perform the unfollow action with the current metadata. If there's no specified attribute in the current metadata, the controller must not omit this argument.

public static final String ARGUMENT_MEDIA_ATTRIBUTE = "android.support.v4.media.session.ARGUMENT_MEDIA_ATTRIBUTE"

Argument to indicate the media attribute. It should be one of the following:

• MEDIA_ATTRIBUTE_ARTIST
• MEDIA_ATTRIBUTE_PLAYLIST
• MEDIA_ATTRIBUTE_ALBUM

public static final String ARGUMENT_MEDIA_ATTRIBUTE_VALUE = "android.support.v4.media.session.ARGUMENT_MEDIA_ATTRIBUTE_VALUE"

String argument to indicate the value of the media attribute (e.g., the name of the artist).

public static final int FLAG_HANDLES_MEDIA_BUTTONS = 1

Sets this flag on the session to indicate that it can handle media button events.

public static final int FLAG_HANDLES_QUEUE_COMMANDS = 4

Sets this flag on the session to indicate that it handles queue management commands through its Callback.

public static final int FLAG_HANDLES_TRANSPORT_CONTROLS = 2

Sets this flag on the session to indicate that it handles transport control commands through its Callback.

public static final int MEDIA_ATTRIBUTE_ALBUM = 1

The value of ARGUMENT_MEDIA_ATTRIBUTE indicating the album.

public static final int MEDIA_ATTRIBUTE_ARTIST = 0

The value of ARGUMENT_MEDIA_ATTRIBUTE indicating the artist.

public static final int MEDIA_ATTRIBUTE_PLAYLIST = 2

The value of ARGUMENT_MEDIA_ATTRIBUTE indicating the playlist.

public MediaSessionCompat(@NonNull Context context, @NonNull String tag)

Creates a new session. You must call release when finished with the session.

The session will automatically be registered with the system but will not be published until setActive(true) is called.

For API 20 or earlier, note that a media button receiver is required for handling ACTION_MEDIA_BUTTON. This constructor will attempt to find an appropriate BroadcastReceiver from your manifest. See MediaButtonReceiver for more details.

public MediaSessionCompat(
    @NonNull Context context,
    @NonNull String tag,
    @Nullable ComponentName mbrComponent,
    @Nullable PendingIntent mbrIntent
)

Creates a new session with a specified media button receiver (a component name and/or a pending intent). You must call release when finished with the session.

The session will automatically be registered with the system but will not be published until setActive(true) is called.

For API 20 or earlier, note that a media button receiver is required for handling ACTION_MEDIA_BUTTON. This constructor will attempt to find an appropriate BroadcastReceiver from your manifest if it's not specified. See MediaButtonReceiver for more details.

public MediaSessionCompat(
    @NonNull Context context,
    @NonNull String tag,
    @Nullable ComponentName mbrComponent,
    @Nullable PendingIntent mbrIntent,
    @Nullable Bundle sessionInfo
)

Creates a new session with a specified media button receiver (a component name and/or a pending intent). You must call release when finished with the session.

The session will automatically be registered with the system but will not be published until setActive(true) is called.

For API 20 or earlier, note that a media button receiver is required for handling ACTION_MEDIA_BUTTON. This constructor will attempt to find an appropriate BroadcastReceiver from your manifest if it's not specified. See MediaButtonReceiver for more details.

public void addOnActiveChangeListener(
    MediaSessionCompat.OnActiveChangeListener listener
)

Adds a listener to be notified when the active status of this session changes. This is primarily used by the support library and should not be needed by apps.

public static MediaSessionCompat fromMediaSession(Context context, Object mediaSession)

Creates an instance from a framework android.media.session.MediaSession object.

This method is only supported on API 21+. On API 20 and below, it returns null.

Note: A MediaSessionCompat object returned from this method may not provide the full functionality of MediaSessionCompat until setting a new MediaSessionCompat.Callback. To avoid this, when both a MediaSessionCompat and a framework android.media.session.MediaSession are needed, it is recommended to create a MediaSessionCompat first and get the framework session through getMediaSession.

public MediaControllerCompat getController()

Gets a controller for this session. This is a convenience method to avoid having to cache your own controller in process.

public final @NonNull MediaSessionManager.RemoteUserInfo getCurrentControllerInfo()

Gets the controller information who sent the current request.

Note: This is only valid while in a request callback, such as onPlay.

Note: From API 21 to 23, this method returns a fake RemoteUserInfo which has following values:

• Package name is LEGACY_CONTROLLER.
• PID and UID will have negative values.

Note: From API 24 to 27, the RemoteUserInfo returned from this method will have negative uid and pid. Most of the cases it will have the correct package name, but sometimes it will fail to get the right one.

public Object getMediaSession()

Gets the underlying framework android.media.session.MediaSession object.

This method is only supported on API 21+.

public Object getRemoteControlClient()

Gets the underlying framework android.media.RemoteControlClient object.

This method is only supported on APIs 14-20. On API 21+ getMediaSession should be used instead.

public MediaSessionCompat.Token getSessionToken()

Retrieves a token object that can be used by apps to create a MediaControllerCompat for interacting with this session. The owner of the session is responsible for deciding how to distribute these tokens.

On platform versions before LOLLIPOP this token may only be used within your app as there is no way to guarantee other apps are using the same version of the support library.

public boolean isActive()

Gets the current active state of this session.

public void release()

This must be called when an app has finished performing playback. If playback is expected to start again shortly the session can be left open, but it must be released if your activity or service is being destroyed.

public void removeOnActiveChangeListener(
    MediaSessionCompat.OnActiveChangeListener listener
)

Stops the listener from being notified when the active status of this session changes.

public void sendSessionEvent(String event, Bundle extras)

Sends a proprietary event to all MediaControllers listening to this Session. It's up to the Controller/Session owner to determine the meaning of any events.

public void setActive(boolean active)

Sets if this session is currently active and ready to receive commands. If set to false your session's controller may not be discoverable. You must set the session to active before it can start receiving media button events or transport commands.

On platforms earlier than LOLLIPOP, a media button event receiver should be set via the constructor to receive media button events.

public void setCallback(MediaSessionCompat.Callback callback)

Adds a callback to receive updates on for the MediaSession. This includes media button a