RouteInfo

class RouteInfo

kotlin.Any
↳	androidx.mediarouter.media.MediaRouter.RouteInfo

Provides information about a media route.

Each media route has a list of media control intent filters that describe the capabilities of the route and the manner in which it is used and controlled.

Summary

Constants
static Int	`CONNECTION_STATE_DISCONNECTED` The default connection state indicating the route is disconnected.
static Int	`CONNECTION_STATE_CONNECTING` A connection state indicating the route is in the process of connecting and is not yet ready for use.
static Int	`CONNECTION_STATE_CONNECTED` A connection state indicating the route is connected.
static 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.
static 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.
static Int	`DEVICE_TYPE_TV` A receiver device type of the route indicating the presentation of the media is happening on a TV.
static Int	`DEVICE_TYPE_SPEAKER` A receiver device type of the route indicating the presentation of the media is happening on a speaker.
static Int	`PLAYBACK_VOLUME_FIXED` Playback information indicating the playback volume is fixed, i.
static Int	`PLAYBACK_VOLUME_VARIABLE` Playback information indicating the playback volume is variable and can be controlled from this object.

Public methods
open Boolean	`isConnecting()` Returns true if the route is in the process of connecting and is not yet ready for use.
open String	`getId()` Gets the unique id of the route.
open Int	`getPlaybackType()` Gets the type of playback associated with this route.
open Int	`getVolume()` Gets the current volume for this route.
open Boolean	`isDeviceSpeaker()` Returns true if this route is the default route and the device speaker.
open String?	`getDescription()` Gets the user-visible description of the route.
open Unit	`requestSetVolume(volume: Int)` Requests a volume change for this route asynchronously.
open Boolean	`supportsControlAction(@NonNull category: String, @NonNull action: String)` Returns true if the route supports the specified `media control` category and action.
open Display?	`getPresentationDisplay()` Gets the `Display` that should be used by the application to show a `android.app.Presentation` on an external display when this route is selected.
open Int	`getConnectionState()` Gets the connection state of the route.
open String	`toString()`
open Boolean	`isEnabled()` Returns true if this route is enabled and may be selected.
open MutableList<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.
open MediaRouter.ProviderInfo!	`getProvider()` Gets information about the provider of this media route.
open Boolean	`isBluetooth()` Returns true if this route is a bluetooth route.
open Boolean	`isDefault()` Returns true if this route is the default route.
open Int	`getPlaybackStream()` Gets the audio stream over which the playback associated with this route is performed.
open IntentSender?	`getSettingsIntent()` Gets an intent sender for launching a settings activity for this route.
open Boolean	`canDisconnect()` Gets whether this route supports disconnecting without interrupting playback.
open String!	`getName()` Gets the user-visible name of the route.
open Bundle?	`getExtras()` Gets a collection of extra properties about this route that were supplied by its media route provider, or null if none.
open Boolean	`supportsControlCategory(@NonNull category: String)` Returns true if the route supports the specified `media control` category.
open Unit	`sendControlRequest(@NonNull intent: Intent, @Nullable callback: MediaRouter.ControlRequestCallback?)` Sends a `media control` request to be performed asynchronously by the route's destination.
open Int	`getVolumeHandling()` Gets information about how volume is handled on the route.
open Boolean	`isSelected()` Returns true if this route is currently selected.
open Unit	`requestUpdateVolume(delta: Int)` Requests an incremental volume update for this route asynchronously.
open Int	`getDeviceType()` Gets the type of the receiver device associated with this route.
open Unit	`select()` Selects this media route.
open Boolean	`matchesSelector(@NonNull selector: MediaRouteSelector)` Returns true if the route supports at least one of the capabilities described by a media route selector.
open Boolean	`supportsControlRequest(@NonNull intent: Intent)` Returns true if the route supports the specified `media control` request.
open Uri!	`getIconUri()` Gets the URI of the icon representing this route.
open Int	`getVolumeMax()` Gets the maximum volume at which the playback associated with this route is performed.

Constants

CONNECTION_STATE_DISCONNECTED

static val CONNECTION_STATE_DISCONNECTED: Int

The default connection state indicating the route is disconnected.

Value: 0

See Also

#getConnectionState

CONNECTION_STATE_CONNECTING

static val CONNECTION_STATE_CONNECTING: Int

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

Value: 1

See Also

#getConnectionState

CONNECTION_STATE_CONNECTED

static val CONNECTION_STATE_CONNECTED: Int

A connection state indicating the route is connected.

Value: 2

See Also

#getConnectionState

PLAYBACK_TYPE_LOCAL

static val PLAYBACK_TYPE_LOCAL: Int

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.

Value: 0

See Also

#getPlaybackType

PLAYBACK_TYPE_REMOTE

static val PLAYBACK_TYPE_REMOTE: Int

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.

Value: 1

See Also

#getPlaybackType

DEVICE_TYPE_TV

static val DEVICE_TYPE_TV: Int

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

Value: 1

See Also

#getDeviceType

DEVICE_TYPE_SPEAKER

static val DEVICE_TYPE_SPEAKER: Int

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

Value: 2

See Also

#getDeviceType

PLAYBACK_VOLUME_FIXED

static val PLAYBACK_VOLUME_FIXED: Int

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.

Value: 0

See Also

#getVolumeHandling

PLAYBACK_VOLUME_VARIABLE

static val PLAYBACK_VOLUME_VARIABLE: Int

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

Value: 1

See Also

#getVolumeHandling

Public methods

isConnecting

open fun isConnecting(): Boolean

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

Return
Boolean: True if this route is in the process of connecting.

getId

@NonNull open fun getId(): String

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.

Return
String: The unique id of the route, never null.

getPlaybackType

open fun getPlaybackType(): Int

Gets the type of playback associated with this route.

Return
Int: The type of playback associated with this route: `PLAYBACK_TYPE_LOCAL` or `PLAYBACK_TYPE_REMOTE`.

getVolume

open fun getVolume(): Int

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

Return
Int: The volume at which the playback associated with this route is performed.

isDeviceSpeaker

open fun isDeviceSpeaker(): Boolean

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

Return
Boolean: True if this route is the default route and the device speaker.

getDescription

@Nullable open fun getDescription(): String?

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.

Return
String?: The description of the route, or null if none.

requestSetVolume

open fun requestSetVolume(volume: Int): Unit

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.

Parameters
`volume`	Int: The new volume value between 0 and `getVolumeMax`.

supportsControlAction

open fun supportsControlAction(@NonNull category: String, @NonNull action: String): Boolean

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.

Parameters
`category`	String: A `media control` category such as `MediaControlIntent#CATEGORY_LIVE_AUDIO`, `MediaControlIntent#CATEGORY_LIVE_VIDEO`, `MediaControlIntent#CATEGORY_REMOTE_PLAYBACK`, or a provider-defined media control category.
`action`	String: A `media control` action such as `MediaControlIntent#ACTION_PLAY`.

Return
Boolean: True if the route supports the specified intent action.

See Also

MediaControlIntent#getControlFilters

getPresentationDisplay

@Nullable open fun getPresentationDisplay(): Display?

Gets the Display that should be used by the application to show a android.app.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 Callback#onRoutePresentationDisplayChanged callback and show or dismiss its android.app.Presentation accordingly when the display becomes available or is removed.

This method only makes sense for live video routes.

Return
Display?: The preferred presentation display to use when this route is selected or null if none.

See Also

MediaControlIntent#CATEGORY_LIVE_VIDEOandroid.app.Presentation

getConnectionState

open fun getConnectionState(): Int

Gets the connection state of the route.

Return
Int: The connection state of this route: `CONNECTION_STATE_DISCONNECTED`, `CONNECTION_STATE_CONNECTING`, or `CONNECTION_STATE_CONNECTED`.

toString

open fun toString(): String

isEnabled

open fun isEnabled(): Boolean

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

Return
Boolean: True if this route is enabled.

getControlFilters

open fun getControlFilters(): MutableList<IntentFilter!>!

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

Return
MutableList<IntentFilter!>!: A list of intent filters that specifies the media control intents that this route supports.

See Also

MediaControlIntent#supportsControlCategory#supportsControlRequest

getProvider

open fun getProvider(): MediaRouter.ProviderInfo!

Gets information about the provider of this media route.

isBluetooth

open fun isBluetooth(): Boolean

Returns true if this route is a bluetooth route.

Return
Boolean: True if this route is a bluetooth route.

See Also

MediaRouter#getBluetoothRoute

isDefault

open fun isDefault(): Boolean

Returns true if this route is the default route.

Return
Boolean: True if this route is the default route.

See Also

MediaRouter#getDefaultRoute

getPlaybackStream

open fun getPlaybackStream(): Int

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

Return
Int: The stream over which the playback associated with this route is performed.

getSettingsIntent

@Nullable open fun getSettingsIntent(): IntentSender?

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

canDisconnect

open fun canDisconnect(): Boolean

Gets whether this route supports disconnecting without interrupting playback.

Return
Boolean: True if this route can disconnect without stopping playback, false otherwise.

getName

open fun getName(): String!

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.

Return
String!: The user-visible name of a media route. This is the string presented to users who may select this as the active route.

getExtras

@Nullable open fun getExtras(): Bundle?

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

supportsControlCategory

open fun supportsControlCategory(@NonNull category: String): Boolean

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.

Parameters
`category`	String: A `media control` category such as `MediaControlIntent#CATEGORY_LIVE_AUDIO`, `MediaControlIntent#CATEGORY_LIVE_VIDEO`, `MediaControlIntent#CATEGORY_REMOTE_PLAYBACK`, or a provider-defined media control category.

Return
Boolean: True if the route supports the specified intent category.

See Also

MediaControlIntent#getControlFilters

sendControlRequest

open fun sendControlRequest(@NonNull intent: Intent, @Nullable callback: MediaRouter.ControlRequestCallback?): Unit

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.

Parameters
`intent`	Intent: A `media control intent`.
`callback`	Intent: A `ControlRequestCallback` to invoke with the result of the request, or null if no result is required.

See Also

MediaControlIntent

getVolumeHandling

open fun getVolumeHandling(): Int

Gets information about how volume is handled on the route.

Return
Int: How volume is handled on the route: `PLAYBACK_VOLUME_FIXED` or `PLAYBACK_VOLUME_VARIABLE`.

isSelected

open fun isSelected(): Boolean

Returns true if this route is currently selected.

Return
Boolean: True if this route is currently selected.

See Also

MediaRouter#getSelectedRoute

requestUpdateVolume

open fun requestUpdateVolume(delta: Int): Unit

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.

Parameters
`delta`	Int: The delta to add to the current volume.

getDeviceType

open fun getDeviceType(): Int

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

Return
Int: The type of the receiver device associated with this route: `DEVICE_TYPE_TV` or `DEVICE_TYPE_SPEAKER`.

select

open fun select(): Unit

Selects this media route.

matchesSelector

open fun matchesSelector(@NonNull selector: MediaRouteSelector): Boolean

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

Parameters
`selector`	MediaRouteSelector: The selector that specifies the capabilities to check.

Return
Boolean: True if the route supports at least one of the capabilities described in the media route selector.

supportsControlRequest

open fun supportsControlRequest(@NonNull intent: Intent): Boolean

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.

Parameters
`intent`	Intent: A `media control intent`.

Return
Boolean: True if the route can handle the specified intent.

See Also

MediaControlIntent#getControlFilters

getIconUri

open fun getIconUri(): Uri!

Gets the URI of the icon representing this route.

This icon will be used in picker UIs if available.

Return
Uri!: The URI of the icon representing this route, or null if none.

getVolumeMax

open fun getVolumeMax(): Int

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

Return
Int: The maximum volume at which the playback associated with this route is performed.