Skip to content

Most visited

Recently visited

navigation

MediaController

public final class MediaController
extends Object

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


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.

Inherited methods

From class java.lang.Object

Public constructors

MediaController

added in API level 21
MediaController (Context context, 
                MediaSession.Token token)

Create a new MediaController from a session's token.

Parameters
context Context: The caller's context.

This value must never be null.

token MediaSession.Token: The token for the session.

This value must never be null.

Public methods

adjustVolume

added in API level 21
void adjustVolume (int direction, 
                int flags)

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 int: The direction to adjust the volume in.

flags int: Any flags to pass with the command.

See also:

dispatchMediaButtonEvent

added in API level 21
boolean dispatchMediaButtonEvent (KeyEvent keyEvent)

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 KeyEvent: The media button event to dispatch.

This value must never be null.

Returns
boolean true if the event was sent to the session, false otherwise.

getExtras

added in API level 21
Bundle getExtras ()

Get the extras for this session.

Returns
Bundle

This value may be null.

getFlags

added in API level 21
long getFlags ()

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

Returns
long The current set of flags for the session.

getMetadata

added in API level 21
MediaMetadata getMetadata ()

Get the current metadata for this session.

Returns
MediaMetadata The current MediaMetadata or null.

getPackageName

added in API level 21
String getPackageName ()

Get the session owner's package name.

Returns
String The package name of of the session owner.

getPlaybackInfo

added in API level 21
MediaController.PlaybackInfo getPlaybackInfo ()

Get the current playback info for this session.

Returns
MediaController.PlaybackInfo The current playback info or null.

getPlaybackState

added in API level 21
PlaybackState getPlaybackState ()

Get the current playback state for this session.

Returns
PlaybackState The current PlaybackState or null

getQueue

added in API level 21
List<MediaSession.QueueItem> getQueue ()

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
List<MediaSession.QueueItem> The current play queue or null.

getQueueTitle

added in API level 21
CharSequence getQueueTitle ()

Get the queue title for this session.

Returns
CharSequence

This value may be null.

getRatingType

added in API level 21
int getRatingType ()

Get the rating type supported by the session. One of:

Returns
int The supported rating type

getSessionActivity

added in API level 21
PendingIntent getSessionActivity ()

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

Returns
PendingIntent A PendingIntent to launch UI or null.

getSessionToken

added in API level 21
MediaSession.Token getSessionToken ()

Get the token for the session this is connected to.

Returns
MediaSession.Token The token for the connected session.

This value will never be null.

getTransportControls

added in API level 21
MediaController.TransportControls getTransportControls ()

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

Returns
MediaController.TransportControls A transport controls instance.

This value will never be null.

registerCallback

added in API level 21
void registerCallback (MediaController.Callback callback, 
                Handler handler)

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

Parameters
callback MediaController.Callback: The callback object, must not be null.

handler Handler: The handler to post updates on. If null the callers thread will be used.

registerCallback

added in API level 21
void registerCallback (MediaController.Callback callback)

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

Parameters
callback MediaController.Callback: The callback object, must not be null.

sendCommand

added in API level 21
void sendCommand (String command, 
                Bundle args, 
                ResultReceiver cb)

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 String: The command to send

This value must never be null.

args Bundle: Any parameters to include with the command

This value may be null.

cb ResultReceiver: The callback to receive the result on

This value may be null.

setVolumeTo

added in API level 21
void setVolumeTo (int value, 
                int flags)

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 int: The value to set it to, between 0 and the reported max.

flags int: Flags from AudioManager to include with the volume request.

See also:

unregisterCallback

added in API level 21
void unregisterCallback (MediaController.Callback callback)

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

Parameters
callback MediaController.Callback: The callback to remove.

This value must never be null.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)