MediaBrowser.Builder
public final class MediaBrowser.Builder
Builder for MediaBrowser.
To set the token of the session for the controller to connect to, one of the setSessionToken or setSessionCompatToken should be called. Otherwise, the build will throw an .
Any incoming event from the MediaSession will be handled on the callback executor.
Summary
Public methods |
|
|---|---|
@NonNull MediaBrowser |
build()Builds a |
@NonNull MediaBrowser.Builder |
setConnectionHints(@NonNull Bundle connectionHints)Sets the connection hints for the controller. |
@NonNull MediaBrowser.Builder |
setControllerCallback(Sets the callback for the controller and its executor. |
@NonNull MediaBrowser.Builder |
setSessionCompatToken(@NonNull MediaSessionCompat.Token compatToken)Sets the |
@NonNull MediaBrowser.Builder |
setSessionToken(@NonNull SessionToken token)Sets the |
Public constructors
Public methods
public @NonNull MediaBrowser build()
Builds a MediaBrowser.
| Returns | |
|---|---|
@NonNull MediaBrowser |
a new browser |
| Throws | |
|---|---|
java.lang.IllegalArgumentException |
if both |
public @NonNull MediaBrowser.Builder setConnectionHints(@NonNull Bundle connectionHints)
Sets the connection hints for the controller.
connectionHints is a session-specific argument to send to the session when connecting. The contents of this bundle may affect the connection result.
The hints specified here are only used when when connecting to the MediaSession. They will be ignored when connecting to MediaSessionCompat.
| Returns | |
|---|---|
@NonNull MediaBrowser.Builder |
the Builder to allow chaining |
| Throws | |
|---|---|
java.lang.IllegalArgumentException |
if the bundle contains any non-framework Parcelable objects. |
public @NonNull MediaBrowser.Builder setControllerCallback(
@NonNull Executor executor,
@NonNull MediaBrowser.BrowserCallback callback
)
Sets the callback for the controller and its executor.
| Parameters | |
|---|---|
@NonNull Executor executor |
callback executor |
@NonNull MediaBrowser.BrowserCallback callback |
controller callback. |
| Returns | |
|---|---|
@NonNull MediaBrowser.Builder |
the Builder to allow chaining |
public @NonNull MediaBrowser.Builder setSessionCompatToken(@NonNull MediaSessionCompat.Token compatToken)
Sets the MediaSessionCompat.Token for the controller to connect to.
When this method is called, the SessionToken which was set by calling setSessionToken is removed.
| Parameters | |
|---|---|
@NonNull MediaSessionCompat.Token compatToken |
token to connect to |
| Returns | |
|---|---|
@NonNull MediaBrowser.Builder |
the Builder to allow chaining |
public @NonNull MediaBrowser.Builder setSessionToken(@NonNull SessionToken token)
Sets the SessionToken for the controller to connect to.
When this method is called, the MediaSessionCompat.Token which was set by calling setSessionCompatToken is removed.
Detailed behavior of the MediaController differs according to the type of the token as follows.
- Connected to a
TYPE_SESSIONtokenThe controller connects to the specified session directly. It's recommended when you're sure which session to control, or a you've got token directly from the session app.
This can be used only when the session for the token is running. Once the session is closed, the token becomes unusable.
- Connected to a
TYPE_SESSION_SERVICEorTYPE_LIBRARY_SERVICEThe controller connects to the session provided by the onGetSession. It's up to the service's decision which session would be returned for the connection. Use the getConnectedSessionToken to know the connected session.
This can be used regardless of the session app is running or not. The controller would bind to the service while connected to wake up and keep the service process running.
| Parameters | |
|---|---|
@NonNull SessionToken token |
token to connect to |
| Returns | |
|---|---|
@NonNull MediaBrowser.Builder |
the Builder to allow chaining |