added in version 24.1.0
belongs to Maven artifact com.android.support:support-media-compat:28.0.0-alpha1

MediaBrowserServiceCompat.BrowserRoot

public static final class MediaBrowserServiceCompat.BrowserRoot
extends Object

java.lang.Object
   ↳ android.support.v4.media.MediaBrowserServiceCompat.BrowserRoot


Contains information that the browser service needs to send to the client when first connected.

Summary

Constants

String EXTRA_OFFLINE

The lookup key for a boolean that indicates whether the browser service should return a browser root for offline media items.

String EXTRA_RECENT

The lookup key for a boolean that indicates whether the browser service should return a browser root for recently played media items.

String EXTRA_SUGGESTED

The lookup key for a boolean that indicates whether the browser service should return a browser root for suggested media items.

String EXTRA_SUGGESTION_KEYWORDS

This constant was deprecated in API level 25.4.0. The search functionality is now supported by the methods search(String, Bundle, MediaBrowserCompat.SearchCallback) and onSearch(String, Bundle, MediaBrowserServiceCompat.Result>). Use those methods instead.

Public constructors

MediaBrowserServiceCompat.BrowserRoot(String rootId, Bundle extras)

Constructs a browser root.

Public methods

Bundle getExtras()

Gets any extras about the browser service.

String getRootId()

Gets the root id for browsing.

Inherited methods

From class java.lang.Object

Constants

EXTRA_OFFLINE

added in version 24.1.0
String EXTRA_OFFLINE

The lookup key for a boolean that indicates whether the browser service should return a browser root for offline media items.

When creating a media browser for a given media browser service, this key can be supplied as a root hint for retrieving media items that are can be played without an internet connection. If the media browser service can provide such media items, the implementation must return the key in the root hint when onGetRoot(String, int, Bundle) is called back.

The root hint may contain multiple keys.

Constant Value: "android.service.media.extra.OFFLINE"

EXTRA_RECENT

added in version 24.1.0
String EXTRA_RECENT

The lookup key for a boolean that indicates whether the browser service should return a browser root for recently played media items.

When creating a media browser for a given media browser service, this key can be supplied as a root hint for retrieving media items that are recently played. If the media browser service can provide such media items, the implementation must return the key in the root hint when onGetRoot(String, int, Bundle) is called back.

The root hint may contain multiple keys.

Constant Value: "android.service.media.extra.RECENT"

EXTRA_SUGGESTED

added in version 24.1.0
String EXTRA_SUGGESTED

The lookup key for a boolean that indicates whether the browser service should return a browser root for suggested media items.

When creating a media browser for a given media browser service, this key can be supplied as a root hint for retrieving the media items suggested by the media browser service. The list of media items passed in onChildrenLoaded(String, List) is considered ordered by relevance, first being the top suggestion. If the media browser service can provide such media items, the implementation must return the key in the root hint when onGetRoot(String, int, Bundle) is called back.

The root hint may contain multiple keys.

Constant Value: "android.service.media.extra.SUGGESTED"

EXTRA_SUGGESTION_KEYWORDS

added in version 25.1.0
String EXTRA_SUGGESTION_KEYWORDS

This constant was deprecated in API level 25.4.0.
The search functionality is now supported by the methods search(String, Bundle, MediaBrowserCompat.SearchCallback) and onSearch(String, Bundle, MediaBrowserServiceCompat.Result>). Use those methods instead.

The lookup key for a string that indicates specific keywords which will be considered when the browser service suggests media items.

When creating a media browser for a given media browser service, this key can be supplied as a root hint together with EXTRA_SUGGESTED for retrieving suggested media items related with the keywords. The list of media items passed in onChildrenLoaded(String, List) is considered ordered by relevance, first being the top suggestion. If the media browser service can provide such media items, the implementation must return the key in the root hint when onGetRoot(String, int, Bundle) is called back.

The root hint may contain multiple keys.

Constant Value: "android.service.media.extra.SUGGESTION_KEYWORDS"

Public constructors

MediaBrowserServiceCompat.BrowserRoot

added in version 24.1.0
MediaBrowserServiceCompat.BrowserRoot (String rootId,
                Bundle extras)

Constructs a browser root.

Parameters
rootId String: The root id for browsing.

extras Bundle: Any extras about the browser service.

Public methods

getExtras

added in version 24.1.0
Bundle getExtras ()

Gets any extras about the browser service.

Returns
Bundle

getRootId

added in version 24.1.0
String getRootId ()

Gets the root id for browsing.

Returns
String