MediaRouter.RouteInfo

CONNECTION_STATE_CONNECTED

int CONNECTION_STATE_CONNECTED

A connection state indicating the route is connected.

Constant Value: 2 (0x00000002)

CONNECTION_STATE_CONNECTING

int CONNECTION_STATE_CONNECTING

A connection state indicating the route is in the process of connecting and is not yet ready for use.

Constant Value: 1 (0x00000001)

CONNECTION_STATE_DISCONNECTED

int CONNECTION_STATE_DISCONNECTED

The default connection state indicating the route is disconnected.

Constant Value: 0 (0x00000000)

DEVICE_TYPE_SPEAKER

int DEVICE_TYPE_SPEAKER

A receiver device type of the route indicating the presentation of the media is happening on a speaker.

Constant Value: 2 (0x00000002)

DEVICE_TYPE_TV

int DEVICE_TYPE_TV

A receiver device type of the route indicating the presentation of the media is happening on a TV.

Constant Value: 1 (0x00000001)

PLAYBACK_TYPE_LOCAL

int PLAYBACK_TYPE_LOCAL

The default playback type, "local", indicating the presentation of the media is happening on the same device (e.g. a phone, a tablet) as where it is controlled from.

Constant Value: 0 (0x00000000)

PLAYBACK_TYPE_REMOTE

int PLAYBACK_TYPE_REMOTE

A playback type indicating the presentation of the media is happening on a different device (i.e. the remote device) than where it is controlled from.

Constant Value: 1 (0x00000001)

PLAYBACK_VOLUME_FIXED

int PLAYBACK_VOLUME_FIXED

Playback information indicating the playback volume is fixed, i.e. it cannot be controlled from this object. An example of fixed playback volume is a remote player, playing over HDMI where the user prefers to control the volume on the HDMI sink, rather than attenuate at the source.

Constant Value: 0 (0x00000000)

PLAYBACK_VOLUME_VARIABLE

int PLAYBACK_VOLUME_VARIABLE

Playback information indicating the playback volume is variable and can be controlled from this object.

Constant Value: 1 (0x00000001)

canDisconnect

boolean canDisconnect ()

Gets whether this route supports disconnecting without interrupting playback.

getConnectionState

int getConnectionState ()

Gets the connection state of the route.

getControlFilters

List<IntentFilter> getControlFilters ()

Gets a list of media control intent filters that describe the capabilities of this route and the media control actions that it supports.

getDescription

String getDescription ()

Gets the user-visible description of the route.

The route description describes the kind of destination represented by the route. It may be a user-supplied string, a model number or brand of device.

getDeviceType

int getDeviceType ()

Gets the type of the receiver device associated with this route.

getExtras

Bundle getExtras ()

Gets a collection of extra properties about this route that were supplied by its media route provider, or null if none.

getIconUri

Uri getIconUri ()

Gets the URI of the icon representing this route.

This icon will be used in picker UIs if available.

getId

String getId ()

Gets the unique id of the route.

The route unique id functions as a stable identifier by which the route is known. For example, an application can use this id as a token to remember the selected route across restarts or to communicate its identity to a service.

getName

String getName ()

Gets the user-visible name of the route.

The route name identifies the destination represented by the route. It may be a user-supplied name, an alias, or device serial number.

getPlaybackStream

int getPlaybackStream ()

Gets the audio stream over which the playback associated with this route is performed.

getPlaybackType

int getPlaybackType ()

Gets the type of playback associated with this route.

getPresentationDisplay

Display getPresentationDisplay ()

Gets the Display that should be used by the application to show a Presentation on an external display when this route is selected. Depending on the route, this may only be valid if the route is currently selected.

The preferred presentation display may change independently of the route being selected or unselected. For example, the presentation display of the default system route may change when an external HDMI display is connected or disconnected even though the route itself has not changed.

This method may return null if there is no external display associated with the route or if the display is not ready to show UI yet.

The application should listen for changes to the presentation display using the onRoutePresentationDisplayChanged(MediaRouter, MediaRouter.RouteInfo) callback and show or dismiss its Presentation accordingly when the display becomes available or is removed.

This method only makes sense for live video routes.

getProvider

MediaRouter.ProviderInfo getProvider ()

Gets information about the provider of this media route.

getSettingsIntent

IntentSender getSettingsIntent ()

Gets an intent sender for launching a settings activity for this route.

getVolume

int getVolume ()

Gets the current volume for this route. Depending on the route, this may only be valid if the route is currently selected.

getVolumeHandling

int getVolumeHandling ()

Gets information about how volume is handled on the route.

getVolumeMax

int getVolumeMax ()

Gets the maximum volume at which the playback associated with this route is performed.

isBluetooth

boolean isBluetooth ()

Returns true if this route is a bluetooth route.

isConnecting

boolean isConnecting ()

Returns true if the route is in the process of connecting and is not yet ready for use.

isDefault

boolean isDefault ()

Returns true if this route is the default route.

isDeviceSpeaker

boolean isDeviceSpeaker ()

Returns true if this route is the default route and the device speaker.

isEnabled

boolean isEnabled ()

Returns true if this route is enabled and may be selected.

isSelected

boolean isSelected ()

Returns true if this route is currently selected.

matchesSelector

boolean matchesSelector (MediaRouteSelector selector)

Returns true if the route supports at least one of the capabilities described by a media route selector.

requestSetVolume

void requestSetVolume (int volume)

Requests a volume change for this route asynchronously.

This function may only be called on a selected route. It will have no effect if the route is currently unselected.

requestUpdateVolume

void requestUpdateVolume (int delta)

Requests an incremental volume update for this route asynchronously.

This function may only be called on a selected route. It will have no effect if the route is currently unselected.

select

void select ()

Selects this media route.

sendControlRequest

void sendControlRequest (Intent intent, 
                MediaRouter.ControlRequestCallback callback)

Sends a media control request to be performed asynchronously by the route's destination.

Media control requests are used to request the route to perform actions such as starting remote playback of a media item.

This function may only be called on a selected route. Control requests sent to unselected routes will fail.

supportsControlAction

boolean supportsControlAction (String category, 
                String action)

Returns true if the route supports the specified media control category and action.

Media control actions describe specific requests that an application can ask a route to perform.

supportsControlCategory

boolean supportsControlCategory (String category)

Returns true if the route supports the specified media control category.

Media control categories describe the capabilities of this route such as whether it supports live audio streaming or remote playback.

supportsControlRequest

boolean supportsControlRequest (Intent intent)

Returns true if the route supports the specified media control request.

Media control requests are used to request the route to perform actions such as starting remote playback of a media item.