MediaRouter.Callback
public abstract class MediaRouter.Callback
Interface for receiving events about media routing changes. All methods of this interface will be called from the application's main thread.
A Callback will only receive events relevant to routes that the callback was registered for unless the CALLBACK_FLAG_UNFILTERED_EVENTS flag was specified in addCallback.
| See also | |
|---|---|
addCallback |
|
removeCallback |
Summary
Public constructors |
|---|
Callback() |
Public methods |
|
|---|---|
void |
onProviderAdded(Called when a media route provider has been added. |
void |
onProviderChanged(Called when a property of the indicated media route provider has changed. |
void |
onProviderRemoved(Called when a media route provider has been removed. |
void |
onRouteAdded(Called when a media route has been added. |
void |
onRouteChanged(Called when a property of the indicated media route has changed. |
void |
onRouteConnected(Called when the supplied media route becomes connected. |
void |
onRouteDisconnected(Called when the supplied media route becomes disconnected. |
void |
onRoutePresentationDisplayChanged(Called when a media route's presentation display changes. |
void |
onRouteRemoved(Called when a media route has been removed. |
void |
This method is deprecated. Use |
void |
onRouteSelected(Called when the supplied media route becomes selected as the active route. |
void |
onRouteSelected(Called when the supplied media route becomes selected as the active route, which may be different from the route requested by |
void |
This method is deprecated. Use |
void |
onRouteUnselected(Called when the supplied media route becomes unselected as the active route. |
void |
onRouteVolumeChanged(Called when a media route's volume changes. |
Public constructors
Public methods
onProviderAdded
public void onProviderAdded(
@NonNull MediaRouter router,
@NonNull MediaRouter.ProviderInfo provider
)
Called when a media route provider has been added.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.ProviderInfo provider |
The provider that has become available for use. |
onProviderChanged
public void onProviderChanged(
@NonNull MediaRouter router,
@NonNull MediaRouter.ProviderInfo provider
)
Called when a property of the indicated media route provider has changed.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.ProviderInfo provider |
The provider that was changed. |
onProviderRemoved
public void onProviderRemoved(
@NonNull MediaRouter router,
@NonNull MediaRouter.ProviderInfo provider
)
Called when a media route provider has been removed.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.ProviderInfo provider |
The provider that has been removed from availability. |
onRouteAdded
public void onRouteAdded(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route
)
Called when a media route has been added.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route that has become available for use. |
onRouteChanged
public void onRouteChanged(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route
)
Called when a property of the indicated media route has changed.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route that was changed. |
onRouteConnected
public void onRouteConnected(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo connectedRoute,
@NonNull MediaRouter.RouteInfo requestedRoute
)
Called when the supplied media route becomes connected.
Route connection doesn't affect the selected route. Apps can keep their selected routes while connecting to other routes.
The connected route could be different from the route requested by connect. This can happen when the media transfer feature is enabled.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
the media router reporting the event. |
@NonNull MediaRouter.RouteInfo connectedRoute |
the route that has been connected. |
@NonNull MediaRouter.RouteInfo requestedRoute |
the route that was requested to be connected. |
onRouteDisconnected
public void onRouteDisconnected(
@NonNull MediaRouter router,
@Nullable MediaRouter.RouteInfo disconnectedRoute,
@NonNull MediaRouter.RouteInfo requestedRoute,
int reason
)
Called when the supplied media route becomes disconnected.
Route disconnection doesn't affect the selected route. Apps can keep their selected route while disconnecting other connected routes.
The disconnected route could be different from the route requested by connect or disconnect.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
the media router reporting the event. |
@Nullable MediaRouter.RouteInfo disconnectedRoute |
the route that has been disconnected if the route has an established connection, or |
@NonNull MediaRouter.RouteInfo requestedRoute |
the route that originated the connection request through |
int reason |
the reason for disconnecting the route. |
onRoutePresentationDisplayChanged
public void onRoutePresentationDisplayChanged(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route
)
Called when a media route's presentation display changes.
This method is called whenever the route's presentation display becomes available, is removed or has changes to some of its properties (such as its size).
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route whose presentation display changed. |
| See also | |
|---|---|
getPresentationDisplay |
onRouteRemoved
public void onRouteRemoved(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route
)
Called when a media route has been removed.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route that has been removed from availability. |
public voidonRouteSelected(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route
)
Called when the supplied media route becomes selected as the active route.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route that has been selected. |
onRouteSelected
public void onRouteSelected(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route,
int reason
)
Called when the supplied media route becomes selected as the active route.
The reason provided will be one of the following:
UNSELECT_REASON_UNKNOWNUNSELECT_REASON_DISCONNECTEDUNSELECT_REASON_STOPPEDUNSELECT_REASON_ROUTE_CHANGED
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route that has been selected. |
int reason |
The reason for unselecting the previous route. |
onRouteSelected
public void onRouteSelected(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo selectedRoute,
int reason,
@NonNull MediaRouter.RouteInfo requestedRoute
)
Called when the supplied media route becomes selected as the active route, which may be different from the route requested by selectRoute. That can happen when media transfer feature is enabled. The default implementation calls onRouteSelected with the actually selected route.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo selectedRoute |
The route that has been selected. |
int reason |
The reason for unselecting the previous route. |
@NonNull MediaRouter.RouteInfo requestedRoute |
The route that was requested to be selected. |
public voidonRouteUnselected(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route
)
Called when the supplied media route becomes unselected as the active route. For detailed reason, override onRouteUnselected instead.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route that has been unselected. |
onRouteUnselected
public void onRouteUnselected(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route,
int reason
)
Called when the supplied media route becomes unselected as the active route. The default implementation calls onRouteUnselected.
The reason provided will be one of the following:
UNSELECT_REASON_UNKNOWNUNSELECT_REASON_DISCONNECTEDUNSELECT_REASON_STOPPEDUNSELECT_REASON_ROUTE_CHANGED
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route that has been unselected. |
int reason |
The reason for unselecting the route. |
onRouteVolumeChanged
public void onRouteVolumeChanged(
@NonNull MediaRouter router,
@NonNull MediaRouter.RouteInfo route
)
Called when a media route's volume changes.
| Parameters | |
|---|---|
@NonNull MediaRouter router |
The media router reporting the event. |
@NonNull MediaRouter.RouteInfo route |
The route whose volume changed. |