MediaConstants

public static final String BROWSER_ROOT_HINTS_KEY_CUSTOM_BROWSER_ACTION_LIMIT = "androidx.media.utils.MediaBrowserCompat.extras.CUSTOM_BROWSER_ACTION_LIMIT"

Bundle key used to define the total number of actions allowed per item. Passed to MediaBrowserServiceCompat using onGetRoot in root hints bundle.

Presence of this key and positive value in the root hints indicates that custom browse actions feature is supported. Actions beyond this limit will be truncated.

TYPE: int, number of actions each item is limited to.

public static final String BROWSER_ROOT_HINTS_KEY_MEDIA_ART_SIZE_PIXELS = "android.media.extras.MEDIA_ART_SIZE_HINT_PIXELS"

Bundle key passed through root hints to the MediaBrowserServiceCompat to indicate the recommended size, in pixels, for media art bitmaps. Much smaller images may not render well, and much larger images may cause inefficient resource consumption.

public static final String BROWSER_ROOT_HINTS_KEY_ROOT_CHILDREN_LIMIT = "androidx.media.MediaBrowserCompat.Extras.KEY_ROOT_CHILDREN_LIMIT"

Bundle key passed through root hints to the MediaBrowserServiceCompat to indicate the maximum number of children of the root node that can be supported by the hosting . Excess root children may be omitted or made less discoverable by the host.

TYPE: int

public static final String BROWSER_ROOT_HINTS_KEY_ROOT_CHILDREN_SUPPORTED_FLAGS = "androidx.media.MediaBrowserCompat.Extras.KEY_ROOT_CHILDREN_SUPPORTED_FLAGS"

Bundle key passed through root hints to the MediaBrowserServiceCompat to indicate which flags exposed by getFlags from children of the root node are supported by the hosting MediaBrowserCompat. Root children with unsupported flags may be omitted or made less discoverable by the host.

TYPE: int, a bit field which can be used as a mask. For example, if the value masked (using bitwise AND) with FLAG_BROWSABLE is nonzero, then the host supports browsable root children. Conversely, if the masked result is zero, then the host does not support them.

public static final String BROWSER_SERVICE_EXTRAS_KEY_APPLICATION_PREFERENCES_USING_CAR_APP_LIBRARY_INTENT = "androidx.media.BrowserRoot.Extras.APPLICATION_PREFERENCES_USING_CAR_APP_LIBRARY_INTENT"

Bundle key used to indicate that the MediaBrowserServiceCompat supports showing a settings page.

Use this key to populate the Bundle that you pass to the constructor of the returned by onGetRoot. Use putParcelable to set a for this key. The PendingIntent is created using the getCarApp method.

The Intent carried by the pending intent needs to have the component name set to a Car App Library service that needs to exist in the same application package as the media browser service.

TYPE: PendingIntent.

public static final String BROWSER_SERVICE_EXTRAS_KEY_CUSTOM_BROWSER_ACTION_ROOT_LIST = "androidx.media.utils.extras.CUSTOM_BROWSER_ACTION_ROOT_LIST"

Bundle key used to store supported custom browser actions for media browsers that support custom browser actions.

The browser indicates support for custom browser actions by including the key BROWSER_ROOT_HINTS_KEY_CUSTOM_BROWSER_ACTION_LIMIT with a non-zero value in the root hints bundle passed to onGetRoot.

Use this key to add an ArrayList to the Bundle passed in MediaBrowserServiceCompat.BrowserRoot. MediaBrowserServiceCompat should add this bundle to the MediaBrowserServiceCompat.BrowserRoot when onGetRoot is called. Use putParcelableArrayList with a list of bundles, each defining a custom browser action, to set supported custom browser actions.

TYPE: arraylist, an ArrayList of Bundles, with each bundle defining a browse custom action.

A custom browser action is defined by an action ID, an action label, an action icon URI, and optionally an action extras bundle.

Custom browser action example:

• Action ID: "com.example.audioapp.download"
  • Key: EXTRAS_KEY_CUSTOM_BROWSER_ACTION_ID
• Action label: "Download Song"
  • Key: EXTRAS_KEY_CUSTOM_BROWSER_ACTION_LABEL
  • Localized String label for action
• Action Icon URI: "content://com.example.public/download"
  • Key: EXTRAS_KEY_CUSTOM_BROWSER_ACTION_ICON_URI
  • Tintable vector drawable
• Action extras: {bundle}
  • Key: EXTRAS_KEY_CUSTOM_BROWSER_ACTION_EXTRAS
  • Bundle extras

public static final String BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM = "androidx.media.BrowserRoot.Extras.FAVORITES_MEDIA_ITEM"

Bundle key used to pass a browseable android.media.browse.MediaBrowser.MediaItem that represents 'Favorite' content or some other notion of preset/pinned content.

Use this key to indicate to consumers (e.g. Auto and Automotive) that they can display and/or subscribe to this item.

When this item is subscribed to, it is expected that the MediaBrowserService or MediaBrowserServiceCompat loads content that the user has marked for easy or quick access - e.g. favorite radio stations, pinned playlists, etc.

TYPE: MediaBrowser.MediaItem - note this should not be a MediaBrowserCompat.MediaItem

public static final String BROWSER_SERVICE_EXTRAS_KEY_SEARCH_SUPPORTED = "android.media.browse.SEARCH_SUPPORTED"

Bundle key sent through getExtras to the hosting to indicate that the MediaBrowserServiceCompat supports the method onSearch. If sent as true, the host may expose affordances which call the search method.

TYPE: boolean

public static final String DESCRIPTION_EXTRAS_KEY_COMPLETION_PERCENTAGE = "androidx.media.MediaItem.Extras.COMPLETION_PERCENTAGE"

Bundle key sent through getExtras to the hosting to indicate an amount of completion progress for the corresponding MediaBrowserCompat.MediaItem. This extra augments the partially played status by indicating how much has been played by the user.

TYPE: double, a value between 0.0 and 1.0, inclusive. 0.0 indicates no completion progress (item is not started) and 1.0 indicates full completion progress (item is fully played). Values in between indicate partial progress (for example, 0.75 indicates the item is 75% complete).

public static final String DESCRIPTION_EXTRAS_KEY_COMPLETION_STATUS = "android.media.extra.PLAYBACK_STATUS"

Bundle key sent through getExtras to the hosting to indicate the playback completion status of the corresponding .

TYPE: int. Possible values are separate constants.

public static final String DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_BROWSABLE = "android.media.browse.CONTENT_STYLE_BROWSABLE_HINT"

Bundle key passed from the MediaBrowserServiceCompat to the hosting to indicate a preference about how browsable instances of are presented.

If exposed through getExtras, the preference applies to all browsable items within the browse tree.

If exposed through getExtras, the preference applies to only the immediate browsable children of the corresponding browsable item. It takes precedence over preferences sent through getExtras.

TYPE: int. Possible values are separate constants.

public static final String DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_GROUP_TITLE = "android.media.browse.CONTENT_STYLE_GROUP_TITLE_HINT"

Bundle key sent through getExtras to the hosting to indicate that certain instances of are related as a group, with a title that is specified through the bundle value. Items that are children of the same browsable node and have the same title are members of the same group. The host may present a group's items as a contiguous block and display the title alongside the group.

TYPE: String. Should be human readable and localized.

public static final String DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_PLAYABLE = "android.media.browse.CONTENT_STYLE_PLAYABLE_HINT"

Bundle key passed from the MediaBrowserServiceCompat to the hosting to indicate a preference about how playable instances of are presented.

If exposed through getExtras, the preference applies to all playable items within the browse tree.

If exposed through getExtras, the preference applies to only the immediate playable children of the corresponding browsable item. It takes precedence over preferences sent through getExtras.

TYPE: int. Possible values are separate constants.

public static final String DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_SINGLE_ITEM = "android.media.browse.CONTENT_STYLE_SINGLE_ITEM_HINT"

Bundle key sent through getExtras to the hosting to indicate a preference about how the corresponding is presented.

This preference takes precedence over those expressed by DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_PLAYABLE and DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_BROWSABLE.

TYPE: int. Possible values are separate constants.

public static final String DESCRIPTION_EXTRAS_KEY_CUSTOM_BROWSER_ACTION_ID_LIST = "androidx.media.utils.extras.CUSTOM_BROWSER_ACTION_ID_LIST"

Bundle key used to define a string list of custom browser actions for a MediaBrowserCompat.MediaItem. e.g. "download","favorite","add to queue"

Supported media browsers use this Bundle key to build a list of custom browser actions for each MediaBrowserCompat.MediaItem.

This key is sent through getExtras to the MediaBrowserCompat to indicate supported custom browser actions for the corresponding MediaBrowserCompat.MediaItem.

Use a string array list with a list of custom browser action IDs. Set this bundle in the MediaBrowserCompat.MediaItem using setExtras to set the supported browse custom actions for the MediaBrowserCompat.MediaItem.

Each value action in this list must be an action ID defined in browser root with Bundle key BROWSER_SERVICE_EXTRAS_KEY_CUSTOM_BROWSER_ACTION_ROOT_LIST.

TYPE: ArrayList, list of String custom browser action IDs.

public static final int DESCRIPTION_EXTRAS_VALUE_COMPLETION_STATUS_FULLY_PLAYED = 2

Bundle value sent through getExtras to the hosting to indicate that the corresponding MediaBrowserCompat.MediaItem has been fully played by the user.

public static final int DESCRIPTION_EXTRAS_VALUE_COMPLETION_STATUS_NOT_PLAYED = 0

Bundle value sent through getExtras to the hosting to indicate that the corresponding MediaBrowserCompat.MediaItem has not been played by the user.

public static final int DESCRIPTION_EXTRAS_VALUE_COMPLETION_STATUS_PARTIALLY_PLAYED = 1

Bundle value sent through getExtras to the hosting to indicate that the corresponding MediaBrowserCompat.MediaItem has been partially played by the user.

public static final int DESCRIPTION_EXTRAS_VALUE_CONTENT_STYLE_CATEGORY_GRID_ITEM = 4

Bundle value passed from the MediaBrowserServiceCompat to the hosting to indicate a preference that browsable instances of should be presented as "category" grid items. This means the items must provide tintable vector drawable icons that render well when they:

• do not fill all of the available area
• are tinted by the system to provide sufficient contrast against the background

public static final int DESCRIPTION_EXTRAS_VALUE_CONTENT_STYLE_CATEGORY_LIST_ITEM = 3

Bundle value passed from the MediaBrowserServiceCompat to the hosting to indicate a preference that browsable instances of should be presented as "category" list items. This means the items must provide tintable vector drawable icons that render well when they:

• do not fill all of the available area
• are tinted by the system to provide sufficient contrast against the background

public static final int DESCRIPTION_EXTRAS_VALUE_CONTENT_STYLE_GRID_ITEM = 2

Bundle value passed from the MediaBrowserServiceCompat to the hosting to indicate a preference that certain instances of should be presented as grid items.

public static final int DESCRIPTION_EXTRAS_VALUE_CONTENT_STYLE_LIST_ITEM = 1

Bundle value passed from the MediaBrowserServiceCompat to the hosting to indicate a preference that certain instances of should be presented as list items.

public static final String EXTRAS_KEY_CUSTOM_BROWSER_ACTION_EXTRAS = "androidx.media.utils.extras.KEY_CUSTOM_BROWSER_ACTION_EXTRAS"

Bundle key used to define an extras bundle for a custom browser action.

Use putBundle on the custom browser action bundle to add this extras bundle to the custom browser action.

TYPE: Bundle.

public static final String EXTRAS_KEY_CUSTOM_BROWSER_ACTION_ICON_URI = "androidx.media.utils.extras.KEY_CUSTOM_BROWSER_ACTION_ICON_URI"

Bundle key used to define the icon URI for a custom browser action.

TYPE: String, String content provider URI for a tintable vector drawable icon.

public static final String EXTRAS_KEY_CUSTOM_BROWSER_ACTION_ID = "androidx.media.utils.extras.KEY_CUSTOM_BROWSER_ACTION_ID"

Bundle key used to define the ID for a custom browser action.

TYPE: String, String ID for a custom browser action.

public static final String EXTRAS_KEY_CUSTOM_BROWSER_ACTION_LABEL = "androidx.media.utils.extras.KEY_CUSTOM_BROWSER_ACTION_LABEL"

Bundle key used to define the label for a custom browser action. Label is a localized string that labels the action for the user.

TYPE: String, String label for a custom browser action. This must be localized.

public static final String EXTRAS_KEY_CUSTOM_BROWSER_ACTION_MEDIA_ITEM_ID = "androidx.media.utils.extras.KEY_CUSTOM_BROWSER_ACTION_MEDIA_ITEM_ID"

Bundle key used to define the ID of the