Skip to content

Most visited

Recently visited

navigation

MediaBrowserCompat

public final class MediaBrowserCompat
extends Object

java.lang.Object
   ↳ android.support.v4.media.MediaBrowserCompat


Browses media content offered by a MediaBrowserServiceCompat.

This object is not thread-safe. All calls should happen on the thread on which the browser was constructed.

Summary

Nested classes

class MediaBrowserCompat.ConnectionCallback

Callbacks for connection related events. 

class MediaBrowserCompat.ItemCallback

Callback for receiving the result of getItem(String, MediaBrowserCompat.ItemCallback)

class MediaBrowserCompat.MediaItem

A class with information on a single media item for use in browsing/searching media. 

class MediaBrowserCompat.SearchCallback

Callback for receiving the result of search(String, Bundle, MediaBrowserCompat.SearchCallback)

class MediaBrowserCompat.SubscriptionCallback

Callbacks for subscription related events. 

Constants

String EXTRA_PAGE

Used as an int extra field to denote the page number to subscribe.

String EXTRA_PAGE_SIZE

Used as an int extra field to denote the number of media items in a page.

Public constructors

MediaBrowserCompat(Context context, ComponentName serviceComponent, MediaBrowserCompat.ConnectionCallback callback, Bundle rootHints)

Creates a media browser for the specified media browse service.

Public methods

void connect()

Connects to the media browse service.

void disconnect()

Disconnects from the media browse service.

Bundle getExtras()

Gets any extras for the media service.

void getItem(String mediaId, MediaBrowserCompat.ItemCallback cb)

Retrieves a specific MediaBrowserCompat.MediaItem from the connected service.

String getRoot()

Gets the root id.

ComponentName getServiceComponent()

Gets the service component that the media browser is connected to.

MediaSessionCompat.Token getSessionToken()

Gets the media session token associated with the media browser.

boolean isConnected()

Returns whether the browser is connected to the service.

void search(String query, Bundle extras, MediaBrowserCompat.SearchCallback callback)

Searches media items from the connected service.

void subscribe(String parentId, Bundle options, MediaBrowserCompat.SubscriptionCallback callback)

Queries with service-specific arguments for information about the media items that are contained within the specified id and subscribes to receive updates when they change.

void subscribe(String parentId, MediaBrowserCompat.SubscriptionCallback callback)

Queries for information about the media items that are contained within the specified id and subscribes to receive updates when they change.

void unsubscribe(String parentId)

Unsubscribes for changes to the children of the specified media id.

void unsubscribe(String parentId, MediaBrowserCompat.SubscriptionCallback callback)

Unsubscribes for changes to the children of the specified media id.

Inherited methods

From class java.lang.Object

Constants

EXTRA_PAGE

added in version 24.0.0
String EXTRA_PAGE

Used as an int extra field to denote the page number to subscribe. The value of EXTRA_PAGE should be greater than or equal to 1.

See also:

Constant Value: "android.media.browse.extra.PAGE"

EXTRA_PAGE_SIZE

added in version 24.0.0
String EXTRA_PAGE_SIZE

Used as an int extra field to denote the number of media items in a page. The value of EXTRA_PAGE_SIZE should be greater than or equal to 1.

See also:

Constant Value: "android.media.browse.extra.PAGE_SIZE"

Public constructors

MediaBrowserCompat

added in version 23.2.0
MediaBrowserCompat (Context context, 
                ComponentName serviceComponent, 
                MediaBrowserCompat.ConnectionCallback callback, 
                Bundle rootHints)

Creates a media browser for the specified media browse service.

Parameters
context Context: The context.
serviceComponent ComponentName: The component name of the media browse service.
callback MediaBrowserCompat.ConnectionCallback: The connection callback.
rootHints Bundle: An optional bundle of service-specific arguments to send to the media browse service when connecting and retrieving the root id for browsing, or null if none. The contents of this bundle may affect the information returned when browsing.

See also:

Public methods

connect

added in version 23.2.0
void connect ()

Connects to the media browse service.

The connection callback specified in the constructor will be invoked when the connection completes or fails.

disconnect

added in version 23.2.0
void disconnect ()

Disconnects from the media browse service. After this, no more callbacks will be received.

getExtras

added in version 23.2.0
Bundle getExtras ()

Gets any extras for the media service.

Returns
Bundle
Throws
IllegalStateException if not connected.

getItem

added in version 23.2.0
void getItem (String mediaId, 
                MediaBrowserCompat.ItemCallback cb)

Retrieves a specific MediaBrowserCompat.MediaItem from the connected service. Not all services may support this, so falling back to subscribing to the parent's id should be used when unavailable.

Parameters
mediaId String: The id of the item to retrieve.
cb MediaBrowserCompat.ItemCallback: The callback to receive the result on.

getRoot

added in version 23.2.0
String getRoot ()

Gets the root id.

Note that the root id may become invalid or change when when the browser is disconnected.

Returns
String
Throws
IllegalStateException if not connected.

getServiceComponent

added in version 23.2.0
ComponentName getServiceComponent ()

Gets the service component that the media browser is connected to.

Returns
ComponentName

getSessionToken

added in version 23.2.0
MediaSessionCompat.Token getSessionToken ()

Gets the media session token associated with the media browser.

Note that the session token may become invalid or change when when the browser is disconnected.

Returns
MediaSessionCompat.Token The session token for the browser, never null.
Throws
IllegalStateException if not connected.

isConnected

added in version 23.2.0
boolean isConnected ()

Returns whether the browser is connected to the service.

Returns
boolean

search

added in version 25.3.0
void search (String query, 
                Bundle extras, 
                MediaBrowserCompat.SearchCallback callback)

Searches media items from the connected service. Not all services may support this, and onError(String, Bundle) will be called if not implemented.

Parameters
query String: The search query that contains keywords separated by space. Should not be an empty string.
extras Bundle: The bundle of service-specific arguments to send to the media browser service. The contents of this bundle may affect the search result.
callback MediaBrowserCompat.SearchCallback: The callback to receive the search result. Must be non-null.

subscribe

added in version 24.0.0
void subscribe (String parentId, 
                Bundle options, 
                MediaBrowserCompat.SubscriptionCallback callback)

Queries with service-specific arguments for information about the media items that are contained within the specified id and subscribes to receive updates when they change.

The list of subscriptions is maintained even when not connected and is restored after the reconnection. It is ok to subscribe while not connected but the results will not be returned until the connection completes.

If the id is already subscribed with a different callback then the new callback will replace the previous one and the child data will be reloaded.

Parameters
parentId String: The id of the parent media item whose list of children will be subscribed.
options Bundle: A bundle of service-specific arguments to send to the media browse service. The contents of this bundle may affect the information returned when browsing.
callback MediaBrowserCompat.SubscriptionCallback: The callback to receive the list of children.

subscribe

added in version 23.2.0
void subscribe (String parentId, 
                MediaBrowserCompat.SubscriptionCallback callback)

Queries for information about the media items that are contained within the specified id and subscribes to receive updates when they change.

The list of subscriptions is maintained even when not connected and is restored after the reconnection. It is ok to subscribe while not connected but the results will not be returned until the connection completes.

If the id is already subscribed with a different callback then the new callback will replace the previous one and the child data will be reloaded.

Parameters
parentId String: The id of the parent media item whose list of children will be subscribed.
callback MediaBrowserCompat.SubscriptionCallback: The callback to receive the list of children.

unsubscribe

added in version 23.2.0
void unsubscribe (String parentId)

Unsubscribes for changes to the children of the specified media id.

The query callback will no longer be invoked for results associated with this id once this method returns.

Parameters
parentId String: The id of the parent media item whose list of children will be unsubscribed.

unsubscribe

added in version 24.0.0
void unsubscribe (String parentId, 
                MediaBrowserCompat.SubscriptionCallback callback)

Unsubscribes for changes to the children of the specified media id.

The query callback will no longer be invoked for results associated with this id once this method returns.

Parameters
parentId String: The id of the parent media item whose list of children will be unsubscribed.
callback MediaBrowserCompat.SubscriptionCallback: A callback sent to the media browse service to subscribe.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

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 one-minute survey?
Help us improve Android tools and documentation.