BrowserRoot

Kotlin |Java

class BrowserRoot

kotlin.Any
↳	androidx.media.MediaBrowserServiceCompat.BrowserRoot

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

Summary

Constants
static String	EXTRA_OFFLINE The lookup key for a boolean that indicates whether the browser service should return a browser root for offline media items.
static 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.
static String	EXTRA_SUGGESTED The lookup key for a boolean that indicates whether the browser service should return a browser root for suggested media items.
static String	EXTRA_SUGGESTION_KEYWORDS The lookup key for a string that indicates specific keywords which will be considered when the browser service suggests media items.

Public constructors
<init>(@NonNull rootId: String, @Nullable extras: Bundle?) Constructs a browser root.

Public methods
Bundle!	getExtras() Gets any extras about the browser service.
String!	getRootId() Gets the root id for browsing.

Constants

EXTRA_OFFLINE

static val EXTRA_OFFLINE: String

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.

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

See Also

• #EXTRA_RECENT
• #EXTRA_SUGGESTED

EXTRA_RECENT

static val EXTRA_RECENT: String

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.

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

See Also

• #EXTRA_OFFLINE
• #EXTRA_SUGGESTED

EXTRA_SUGGESTED

static val EXTRA_SUGGESTED: String

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 MediaBrowserCompat.SubscriptionCallback#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.

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

See Also

• #EXTRA_RECENT
• #EXTRA_OFFLINE

EXTRA_SUGGESTION_KEYWORDS

static val EXTRA_SUGGESTION_KEYWORDS: String

Deprecated: The search functionality is now supported by the methods MediaBrowserCompat#search and onSearch. 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 android.media.browse.MediaBrowser.SubscriptionCallback#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.

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

See Also

• #EXTRA_RECENT
• #EXTRA_OFFLINE
• #EXTRA_SUGGESTED

Public constructors

<init>

BrowserRoot(
    @NonNull rootId: String, 
    @Nullable extras: Bundle?)

Constructs a browser root.

Parameters
rootId	String: The root id for browsing.
extras	Bundle?: Any extras about the browser service.

Public methods

getExtras

fun getExtras(): Bundle!

Gets any extras about the browser service.

getRootId

fun getRootId(): String!

Gets the root id for browsing.