Android APIs
public final class

MediaController

extends Object
java.lang.Object
   ↳ android.media.session.MediaController

Class Overview

Allows an app to interact with an ongoing media session. Media buttons and other commands can be sent to the session. A callback may be registered to receive updates from the session, such as metadata and play state changes.

A MediaController can be created through MediaSessionManager if you hold the "android.permission.MEDIA_CONTENT_CONTROL" permission or are an enabled notification listener or by getting a MediaSession.Token directly from the session owner.

MediaController objects are thread-safe.

Summary

Nested Classes
class MediaController.Callback Callback for receiving updates from the session. 
class MediaController.PlaybackInfo Holds information about the current playback and how audio is handled for this session. 
class MediaController.TransportControls Interface for controlling media playback on a session. 
Public Constructors
MediaController(Context context, MediaSession.Token token)
Create a new MediaController from a session's token.
Public Methods
void adjustVolume(int direction, int flags)
Adjust the volume of the output this session is playing on.
boolean dispatchMediaButtonEvent(KeyEvent keyEvent)
Send the specified media button event to the session.
Bundle getExtras()
Get the extras for this session.
long getFlags()
Get the flags for this session.
MediaMetadata getMetadata()
Get the current metadata for this session.
String getPackageName()
Get the session owner's package name.
MediaController.PlaybackInfo getPlaybackInfo()
Get the current playback info for this session.
PlaybackState getPlaybackState()
Get the current playback state for this session.
List<MediaSession.QueueItem> getQueue()
Get the current play queue for this session if one is set.
CharSequence getQueueTitle()
Get the queue title for this session.
int getRatingType()
Get the rating type supported by the session.
PendingIntent getSessionActivity()
Get an intent for launching UI associated with this session if one exists.
MediaSession.Token getSessionToken()
Get the token for the session this is connected to.
MediaController.TransportControls getTransportControls()
Get a MediaController.TransportControls instance to send transport actions to the associated session.
void registerCallback(MediaController.Callback callback, Handler handler)
Registers a callback to receive updates from the session.
void registerCallback(MediaController.Callback callback)
Registers a callback to receive updates from the Session.
void sendCommand(String command, Bundle args, ResultReceiver cb)
Sends a generic command to the session.
void setVolumeTo(int value, int flags)
Set the volume of the output this session is playing on.
void unregisterCallback(MediaController.Callback callback)
Unregisters the specified callback.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public MediaController (Context context, MediaSession.Token token)

Added in API level 21

Create a new MediaController from a session's token.

Parameters
context The caller's context.
token The token for the session.

Public Methods

public void adjustVolume (int direction, int flags)

Added in API level 21

Adjust the volume of the output this session is playing on. The direction must be one of ADJUST_LOWER, ADJUST_RAISE, or ADJUST_SAME. The command will be ignored if the session does not support VOLUME_CONTROL_RELATIVE or VOLUME_CONTROL_ABSOLUTE. The flags in AudioManager may be used to affect the handling.

Parameters
direction The direction to adjust the volume in.
flags Any flags to pass with the command.

public boolean dispatchMediaButtonEvent (KeyEvent keyEvent)

Added in API level 21

Send the specified media button event to the session. Only media keys can be sent by this method, other keys will be ignored.

Parameters
keyEvent The media button event to dispatch.
Returns
  • true if the event was sent to the session, false otherwise.

public Bundle getExtras ()

Added in API level 21

Get the extras for this session.

public long getFlags ()

Added in API level 21

Get the flags for this session. Flags are defined in MediaSession.

Returns
  • The current set of flags for the session.

public MediaMetadata getMetadata ()

Added in API level 21

Get the current metadata for this session.

Returns
  • The current MediaMetadata or null.

public String getPackageName ()

Added in API level 21

Get the session owner's package name.

Returns
  • The package name of of the session owner.

public MediaController.PlaybackInfo getPlaybackInfo ()

Added in API level 21

Get the current playback info for this session.

Returns
  • The current playback info or null.

public PlaybackState getPlaybackState ()

Added in API level 21

Get the current playback state for this session.

Returns
  • The current PlaybackState or null

public List<MediaSession.QueueItem> getQueue ()

Added in API level 21

Get the current play queue for this session if one is set. If you only care about the current item getMetadata() should be used.

Returns
  • The current play queue or null.

public CharSequence getQueueTitle ()

Added in API level 21

Get the queue title for this session.

public int getRatingType ()

Added in API level 21
Returns
  • The supported rating type

public PendingIntent getSessionActivity ()

Added in API level 21

Get an intent for launching UI associated with this session if one exists.

Returns

public MediaSession.Token getSessionToken ()

Added in API level 21

Get the token for the session this is connected to.

Returns
  • The token for the connected session.

public MediaController.TransportControls getTransportControls ()

Added in API level 21

Get a MediaController.TransportControls instance to send transport actions to the associated session.

Returns
  • A transport controls instance.

public void registerCallback (MediaController.Callback callback, Handler handler)

Added in API level 21

Registers a callback to receive updates from the session. Updates will be posted on the specified handler's thread.

Parameters
callback The callback object, must not be null.
handler The handler to post updates on. If null the callers thread will be used.

public void registerCallback (MediaController.Callback callback)

Added in API level 21

Registers a callback to receive updates from the Session. Updates will be posted on the caller's thread.

Parameters
callback The callback object, must not be null.

public void sendCommand (String command, Bundle args, ResultReceiver cb)

Added in API level 21

Sends a generic command to the session. It is up to the session creator to decide what commands and parameters they will support. As such, commands should only be sent to sessions that the controller owns.

Parameters
command The command to send
args Any parameters to include with the command
cb The callback to receive the result on

public void setVolumeTo (int value, int flags)

Added in API level 21

Set the volume of the output this session is playing on. The command will be ignored if it does not support VOLUME_CONTROL_ABSOLUTE. The flags in AudioManager may be used to affect the handling.

Parameters
value The value to set it to, between 0 and the reported max.
flags Flags from AudioManager to include with the volume request.

public void unregisterCallback (MediaController.Callback callback)

Added in API level 21

Unregisters the specified callback. If an update has already been posted you may still receive it after calling this method.

Parameters
callback The callback to remove.