RemotePlaybackClient

public RemotePlaybackClient(
    @NonNull Context context,
    @NonNull MediaRouter.RouteInfo route
)

Creates a remote playback client for a route.

public void endSession(
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.SessionActionCallback callback
)

Sends a request to end the media playback session.

The request is issued in the current session. If this request is successful, the session id property will be set to null after the callback is invoked.

Please refer to ACTION_END_SESSION for more information about the semantics of this request.

public void enqueue(
    @NonNull Uri contentUri,
    @Nullable String mimeType,
    @Nullable Bundle metadata,
    long positionMillis,
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.ItemActionCallback callback
)

Sends a request to enqueue a media item.

Enqueues a new item to play. If the queue was previously paused, then will remain paused.

The request is issued in the current session. If no session is available, then one is created implicitly.

Please refer to ACTION_ENQUEUE for more information about the semantics of this request.

public @Nullable String getSessionId()

Gets the current session id if there is one.

public void getSessionStatus(
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.SessionActionCallback callback
)

Sends a request to get the status of the media playback session.

The request is issued in the current session.

Please refer to ACTION_GET_SESSION_STATUS for more information about the semantics of this request.

public void getStatus(
    @NonNull String itemId,
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.ItemActionCallback callback
)

Sends a request to get the status of a media item.

The request is issued in the current session.

Please refer to ACTION_GET_STATUS for more information about the semantics of this request.

public boolean hasSession()

Returns true if the client currently has a session.

Equivalent to checking whether getSessionId returns a non-null result.

public boolean isMessagingSupported()

Returns true if the route supports messages.

This method returns true if the route supports all of the basic remote playback actions and all of the following actions: start session, send message, end session.

public boolean isQueuingSupported()

Returns true if the route supports queuing features.

If the route does not support queuing, then at most one media item can be played at a time and the enqueue method will not be available.

This method returns true if the route supports all of the basic remote playback actions and all of the following actions: enqueue, remove.

public boolean isRemotePlaybackSupported()

Returns true if the route supports remote playback.

If the route does not support remote playback, then none of the functionality offered by the client will be available.

This method returns true if the route supports all of the following actions: play, seek, get status, pause, resume, stop.

public boolean isSessionManagementSupported()

Returns true if the route supports session management features.

If the route does not support session management, then the session will not be created until the first media item is played.

This method returns true if the route supports all of the basic remote playback actions and all of the following actions: start session, get session status, end session.

public void pause(
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.SessionActionCallback callback
)

Sends a request to pause media playback.

The request is issued in the current session. If playback is already paused then the request has no effect.

Please refer to ACTION_PAUSE for more information about the semantics of this request.

public void play(
    @NonNull Uri contentUri,
    @Nullable String mimeType,
    @Nullable Bundle metadata,
    long positionMillis,
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.ItemActionCallback callback
)

Sends a request to play a media item.

Clears the queue and starts playing the new item immediately. If the queue was previously paused, then it is resumed as a side-effect of this request.

The request is issued in the current session. If no session is available, then one is created implicitly.

Please refer to ACTION_PLAY for more information about the semantics of this request.

public void release()

Releases resources owned by the client.

public void remove(
    @NonNull String itemId,
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.ItemActionCallback callback
)

Sends a request to remove a media item from the queue.

The request is issued in the current session.

Please refer to ACTION_REMOVE for more information about the semantics of this request.

public void resume(
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.SessionActionCallback callback
)

Sends a request to resume (unpause) media playback.

The request is issued in the current session. If playback is not paused then the request has no effect.

Please refer to ACTION_RESUME for more information about the semantics of this request.

public void seek(
    @NonNull String itemId,
    long positionMillis,
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.ItemActionCallback callback
)

Sends a request to seek to a new position in a media item.

Seeks to a new position. If the queue was previously paused then it remains paused but the item's new position is still remembered.

The request is issued in the current session.

Please refer to ACTION_SEEK for more information about the semantics of this request.

public void sendMessage(
    @Nullable Bundle message,
    @Nullable RemotePlaybackClient.SessionActionCallback callback
)

Sends a message.

The request is issued in the current session.

Please refer to ACTION_SEND_MESSAGE for more information about the semantics of this request.

public void setOnMessageReceivedListener(
    @Nullable RemotePlaybackClient.OnMessageReceivedListener listener
)

Sets a callback that should receive messages when a message is sent from media sessions created by this instance of the remote playback client changes.

The callback should be set before the session is created.

public void setSessionId(@Nullable String sessionId)

Sets the current session id.

It is usually not necessary to set the session id explicitly since it is created as a side-effect of other requests such as play, enqueue, and startSession.

public void setStatusCallback(
    @Nullable RemotePlaybackClient.StatusCallback callback
)

Sets a callback that should receive status updates when the state of media sessions or media items created by this instance of the remote playback client changes.

The callback should be set before the session is created or any play commands are issued.

public void startSession(
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.SessionActionCallback callback
)

Sends a request to start a new media playback session.

The application must wait for the callback to indicate that this request is complete before issuing other requests that affect the session. If this request is successful then the previous session will be invalidated.

Please refer to ACTION_START_SESSION for more information about the semantics of this request.

public void stop(
    @Nullable Bundle extras,
    @Nullable RemotePlaybackClient.SessionActionCallback callback
)

Sends a request to stop media playback and clear the media playback queue.

The request is issued in the current session. If the queue is already empty then the request has no effect.

Please refer to ACTION_STOP for more information about the semantics of this request.