MediaSession.Builder
public final class MediaSession.Builder
Builder for MediaSession.
Any incoming event from the MediaController will be handled on the callback executor. If it's not set, getMainExecutor will be used by default.
Summary
Public constructors |
|---|
Builder(@NonNull Context context, @NonNull SessionPlayer player) |
Public methods |
|
|---|---|
@NonNull MediaSession |
build()Builds a |
@NonNull MediaSession.Builder |
Sets extras for the session token. |
@NonNull MediaSession.Builder |
Sets the ID of the session. |
@NonNull MediaSession.Builder |
Sets an intent for launching UI for this Session. |
@NonNull MediaSession.Builder |
setSessionCallback(Sets callback for the session. |
Public constructors
Public methods
public @NonNull MediaSession build()
Builds a MediaSession.
| Returns | |
|---|---|
@NonNull MediaSession |
a new session |
| Throws | |
|---|---|
java.lang.IllegalStateException |
if the session with the same id already exists for the package. |
public @NonNull MediaSession.Builder setExtras(@NonNull Bundle extras)
Sets extras for the session token. If not set, getExtras will return an empty Bundle.
| Returns | |
|---|---|
@NonNull MediaSession.Builder |
the Builder to allow chaining |
| Throws | |
|---|---|
java.lang.IllegalArgumentException |
if the bundle contains any non-framework Parcelable objects. |
| See also | |
|---|---|
getExtras |
public @NonNull MediaSession.Builder setId(@NonNull String id)
Sets the ID of the session. If it's not set, an empty string will be used to create a session.
Use this if and only if your app supports multiple playback at the same time and also wants to provide external apps to have finer controls of them.
| Returns | |
|---|---|
@NonNull MediaSession.Builder |
public @NonNull MediaSession.Builder setSessionActivity(@Nullable PendingIntent pi)
Sets an intent for launching UI for this Session. This can be used as a quick link to an ongoing media screen. The intent should be for an activity that may be started using startActivity.
| Parameters | |
|---|---|
@Nullable PendingIntent pi |
The intent to launch to show UI for this session. |
public @NonNull MediaSession.Builder setSessionCallback(
@NonNull Executor executor,
@NonNull MediaSession.SessionCallback callback
)
Sets callback for the session.
| Parameters | |
|---|---|
@NonNull Executor executor |
callback executor |
@NonNull MediaSession.SessionCallback callback |
session callback |
| Returns | |
|---|---|
@NonNull MediaSession.Builder |