Added in API level 30

Summary: Methods | Inherited Methods

MediaRouter2.RoutingController

Kotlin |Java

public class MediaRouter2.RoutingController
extends Object

java.lang.Object
↳	android.media.MediaRouter2.RoutingController

Controls a media routing session.

Routing controllers wrap a RoutingSessionInfo, taking care of mapping route ids to MediaRoute2Info instances. You can still access the underlying session using getRoutingSessionInfo(), but keep in mind it can be changed by other threads. Changes to the routing session are notified via ControllerCallback.

Summary

Public methods
`void`	`deselectRoute(MediaRoute2Info route)` Deselects a route from the remote session.
`Bundle`	`getControlHints()` Gets the control hints used to control routing session if available.
`List<MediaRoute2Info>`	`getDeselectableRoutes()` Returns the unmodifiable list of deselectable routes for the session.
`String`	`getId()`
`RoutingSessionInfo`	`getRoutingSessionInfo()` Returns the current `RoutingSessionInfo` associated to this controller.
`List<MediaRoute2Info>`	`getSelectableRoutes()` Returns the unmodifiable list of selectable routes for the session.
`List<MediaRoute2Info>`	`getSelectedRoutes()` Returns the unmodifiable list of currently selected routes
`List<MediaRoute2Info>`	`getTransferableRoutes()` Returns the unmodifiable list of transferable routes for the session.
`int`	`getVolume()` Gets the current volume of the session.
`int`	`getVolumeHandling()` Gets the information about how volume is handled on the session.
`int`	`getVolumeMax()` Gets the maximum volume of the session.
`boolean`	`isReleased()` Returns true if this controller is released, false otherwise.
`void`	`release()` Releases this controller and the corresponding session.
`void`	`selectRoute(MediaRoute2Info route)` Selects a route for the remote session.
`void`	`setVolume(int volume)` Requests a volume change for the remote session asynchronously.
`String`	`toString()` Returns a string representation of the object.
`boolean`	`wasTransferInitiatedBySelf()` Returns whether the transfer was initiated by the calling app (as determined by comparing `UserHandle` and package name).

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

deselectRoute

Added in API level 30

public void deselectRoute (MediaRoute2Info route)

Deselects a route from the remote session. After a route is deselected, the media is expected to be stopped on the deselected route.

The given route must satisfy all of the following conditions:

It should be included in getSelectedRoutes()
It should be included in getDeselectableRoutes()

If the route doesn't meet any of above conditions, it will be ignored.

Parameters
`route`	`MediaRoute2Info`: This value cannot be `null`.

See also:

getControlHints

Added in API level 30

public Bundle getControlHints ()

Gets the control hints used to control routing session if available. It is set by the media route provider.

Returns
`Bundle`	This value may be `null`.

getDeselectableRoutes

Added in API level 30

public List<MediaRoute2Info> getDeselectableRoutes ()

Returns the unmodifiable list of deselectable routes for the session.

Returns
`List<MediaRoute2Info>`	This value cannot be `null`.

See also:

RoutingSessionInfo.getDeselectableRoutes()

getId

Added in API level 30

public String getId ()

Returns
`String`	the ID of the controller. It is globally unique. This value cannot be `null`.

getRoutingSessionInfo

Added in API level 34

public RoutingSessionInfo getRoutingSessionInfo ()

Returns the current RoutingSessionInfo associated to this controller.

Returns
`RoutingSessionInfo`	This value cannot be `null`.

getSelectableRoutes

Added in API level 30

public List<MediaRoute2Info> getSelectableRoutes ()

Returns the unmodifiable list of selectable routes for the session.

Returns
`List<MediaRoute2Info>`	This value cannot be `null`.

See also:

RoutingSessionInfo.getSelectableRoutes()

getSelectedRoutes

Added in API level 30

public List<MediaRoute2Info> getSelectedRoutes ()

Returns the unmodifiable list of currently selected routes

Returns
`List<MediaRoute2Info>`	This value cannot be `null`.

See also:

RoutingSessionInfo.getSelectedRoutes()

getTransferableRoutes

Added in API level 35

public List<MediaRoute2Info> getTransferableRoutes ()

Returns the unmodifiable list of transferable routes for the session.

Returns
`List<MediaRoute2Info>`	This value cannot be `null`.

See also:

RoutingSessionInfo.getTransferableRoutes()

getVolume

Added in API level 30

public int getVolume ()

Gets the current volume of the session.

When it's available, it represents the volume of routing session, which is a group of selected routes. Use MediaRoute2Info.getVolume() to get the volume of a route,

Returns
`int`

See also:

MediaRoute2Info.getVolume()

getVolumeHandling

Added in API level 30

public int getVolumeHandling ()

Gets the information about how volume is handled on the session.

Please note that you may not control the volume of the session even when you can control the volume of each selected route in the session.

Returns
`int`	`MediaRoute2Info.PLAYBACK_VOLUME_FIXED` or `MediaRoute2Info.PLAYBACK_VOLUME_VARIABLE` Value is `MediaRoute2Info.PLAYBACK_VOLUME_FIXED`, or `MediaRoute2Info.PLAYBACK_VOLUME_VARIABLE`

getVolumeMax

Added in API level 30

public int getVolumeMax ()

Gets the maximum volume of the session.

Returns
`int`

isReleased

Added in API level 30

public boolean isReleased ()

Returns true if this controller is released, false otherwise. If it is released, then all other getters from this instance may return invalid values. Also, any operations to this instance will be ignored once released.

Returns
`boolean`

See also:

release()

release

Added in API level 30

public void release ()

Releases this controller and the corresponding session. Any operations on this controller after calling this method will be ignored. The devices that are playing media will stop playing it.

selectRoute

Added in API level 30

public void selectRoute (MediaRoute2Info route)

Selects a route for the remote session. After a route is selected, the media is expected to be played to the all the selected routes. This is different from transferring to a route, where the media is expected to 'move' from one route to another.

The given route must satisfy all of the following conditions:

It should not be included in getSelectedRoutes()
It should be included in getSelectableRoutes()

If the route doesn't meet any of above conditions, it will be ignored.

Parameters
`route`	`MediaRoute2Info`: This value cannot be `null`.

See also:

setVolume

Added in API level 30

public void setVolume (int volume)

Requests a volume change for the remote session asynchronously.

Parameters
`volume`	`int`: The new volume value between 0 and `RoutingController.getVolumeMax` (inclusive).

See also:

getVolume()

toString

Added in API level 30

public String toString ()

Returns a string representation of the object.

Returns
`String`	a string representation of the object.

wasTransferInitiatedBySelf

Added in API level 35

public boolean wasTransferInitiatedBySelf ()

Returns whether the transfer was initiated by the calling app (as determined by comparing UserHandle and package name).

Returns
`boolean`