# MediaLibraryService.MediaLibrarySession.Builder

Artifact: [androidx.media3:media3-session](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/session/MediaLibraryService.java+class:androidx.media3.session.MediaLibraryService.MediaLibrarySession.Builder)

*** ** * ** ***


```
public final class MediaLibraryService.MediaLibrarySession.Builder
```

<br />

*** ** * ** ***

A builder for `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`.

Any incoming requests from the `https://developer.android.com/reference/androidx/media3/session/MediaBrowser` will be handled on the application thread of the underlying `https://developer.android.com/reference/androidx/media3/common/Player`.

## Summary

| ### Public constructors |
|---|
| `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#Builder(android.content.Context,androidx.media3.common.Player,androidx.media3.session.MediaLibraryService.MediaLibrarySession.Callback)( https://developer.android.com/reference/android/content/Context.html context, https://developer.android.com/reference/androidx/media3/common/Player player, https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Callback callback )` Creates a builder for `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#Builder(androidx.media3.session.MediaLibraryService,androidx.media3.common.Player,androidx.media3.session.MediaLibraryService.MediaLibrarySession.Callback)( https://developer.android.com/reference/androidx/media3/session/MediaLibraryService service, https://developer.android.com/reference/androidx/media3/common/Player player, https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Callback callback )` Creates a builder for `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. |

| ### Public methods |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession` | `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#build()()` Builds a `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setBitmapLoader(androidx.media3.common.util.BitmapLoader)(https://developer.android.com/reference/androidx/media3/common/util/BitmapLoader bitmapLoader)` Sets a `https://developer.android.com/reference/androidx/media3/common/util/BitmapLoader` for the `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession` to decode bitmaps from compressed binary data or load bitmaps from `https://developer.android.com/reference/android/net/Uri.html`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setCommandButtonsForMediaItems(java.util.List<androidx.media3.session.CommandButton>)(https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/session/CommandButton> commandButtons)` Sets `https://developer.android.com/reference/androidx/media3/session/CommandButton` that can be added as `https://developer.android.com/reference/androidx/media3/common/MediaMetadata.Builder#setSupportedCommands(java.util.List<java.lang.String>)`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi @https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setCustomLayout(java.util.List<androidx.media3.session.CommandButton>)(https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/session/CommandButton> customLayout)` Sets the custom layout of the session. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setExtras(android.os.Bundle)(https://developer.android.com/reference/android/os/Bundle.html tokenExtras)` Sets an extras `https://developer.android.com/reference/android/os/Bundle.html` for the `https://developer.android.com/reference/androidx/media3/session/MediaSession#getToken()`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setId(java.lang.String)(https://developer.android.com/reference/java/lang/String.html id)` Sets an ID of the `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi @https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setLibraryErrorReplicationMode(int)(int libraryErrorReplicationMode)` Sets whether library result errors should be replicated to the platform media session's `https://developer.android.com/reference/android/media/session/PlaybackState.html` as a fatal error, a non-fatal error or not replicated at all. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html @https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setMediaButtonPreferences(java.util.List<androidx.media3.session.CommandButton>)(https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/session/CommandButton> mediaButtonPreferences)` Sets the media button preferences. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi @https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html @https://developer.android.com/reference/androidx/annotation/RequiresPermission(value = "android.permission.OVERRIDE_MEDIA_SESSION_OWNER") https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setPackageNameOverride(java.lang.String)(https://developer.android.com/reference/java/lang/String.html packageNameOverride)` Overrides the package name of the session created. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setPeriodicPositionUpdateEnabled(boolean)(boolean isEnabled)` Sets whether periodic position updates should be sent to controllers while playing. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setSessionActivity(android.app.PendingIntent)(https://developer.android.com/reference/android/app/PendingIntent.html pendingIntent)` Sets a `https://developer.android.com/reference/android/app/PendingIntent.html` to launch an `https://developer.android.com/reference/android/app/Activity.html` for the `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setSessionExtras(android.os.Bundle)(https://developer.android.com/reference/android/os/Bundle.html sessionExtras)` Sets the `https://developer.android.com/reference/androidx/media3/session/MediaSession#getSessionExtras()`. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setShowPlayButtonIfPlaybackIsSuppressed(boolean)( boolean showPlayButtonIfPlaybackIsSuppressed )` Sets whether a play button is shown if playback is `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackSuppressionReason()`. |

| ### Protected methods |
|---|---|
| `final void` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/EnsuresNonNull.html(value = "bitmapLoader") https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#ensureBitmapLoaderIsSizeLimited()()` Updates bitmap loader to ensure its using the maximum media session size limit. |

## Public constructors

### Builder

```
@UnstableApi
public Builder(
    Context context,
    Player player,
    MediaLibraryService.MediaLibrarySession.Callback callback
)
```

Creates a builder for `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/content/Context.html context` | The `https://developer.android.com/reference/android/content/Context.html`. |
| `https://developer.android.com/reference/androidx/media3/common/Player player` | The underlying player to perform playback and handle transport controls. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Callback callback` | The callback to handle requests from `https://developer.android.com/reference/androidx/media3/session/MediaBrowser`. |

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException.html` | if `https://developer.android.com/reference/androidx/media3/common/Player#canAdvertiseSession()` returns false. |

### Builder

```
public Builder(
    MediaLibraryService service,
    Player player,
    MediaLibraryService.MediaLibrarySession.Callback callback
)
```

Creates a builder for `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService service` | The `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService` that instantiates the `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. |
| `https://developer.android.com/reference/androidx/media3/common/Player player` | The underlying player to perform playback and handle transport controls. |
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Callback callback` | The callback to handle requests from `https://developer.android.com/reference/androidx/media3/session/MediaBrowser`. |

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException.html` | if `https://developer.android.com/reference/androidx/media3/common/Player#canAdvertiseSession()` returns false. |

## Public methods

### build

```
public MediaLibraryService.MediaLibrarySession build()
```

Builds a `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession` | A new session. |

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException.html` | if a `https://developer.android.com/reference/androidx/media3/session/MediaSession` with the same `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setId(java.lang.String)` already exists in the package. |

### setBitmapLoader

```
@UnstableApi
public MediaLibraryService.MediaLibrarySession.Builder setBitmapLoader(BitmapLoader bitmapLoader)
```

Sets a `https://developer.android.com/reference/androidx/media3/common/util/BitmapLoader` for the `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession` to decode bitmaps from compressed binary data or load bitmaps from `https://developer.android.com/reference/android/net/Uri.html`.

The provided instance will likely be called repeatedly with the same request, so it would be best if any provided instance does some caching. Simple caching can be added to any `https://developer.android.com/reference/androidx/media3/common/util/BitmapLoader` implementation by wrapping it in `https://developer.android.com/reference/androidx/media3/session/CacheBitmapLoader` before passing it to this method.

If no instance is set, a `https://developer.android.com/reference/androidx/media3/session/CacheBitmapLoader` with a `https://developer.android.com/reference/androidx/media3/datasource/DataSourceBitmapLoader` inside will be used.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/util/BitmapLoader bitmapLoader` | The bitmap loader `https://developer.android.com/reference/androidx/media3/common/util/BitmapLoader`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | The builder to allow chaining. |

### setCommandButtonsForMediaItems

```
@UnstableApi
public MediaLibraryService.MediaLibrarySession.Builder setCommandButtonsForMediaItems(List<CommandButton> commandButtons)
```

Sets `https://developer.android.com/reference/androidx/media3/session/CommandButton` that can be added as `https://developer.android.com/reference/androidx/media3/common/MediaMetadata.Builder#setSupportedCommands(java.util.List<java.lang.String>)`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/session/CommandButton> commandButtons` | The command buttons. |

### setCustomLayout

```
@UnstableApi
@CanIgnoreReturnValue
public MediaLibraryService.MediaLibrarySession.Builder setCustomLayout(List<CommandButton> customLayout)
```

Sets the custom layout of the session.

This method will be deprecated, prefer to use `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder#setMediaButtonPreferences(java.util.List<androidx.media3.session.CommandButton>)`. Note that the media button preferences use `https://developer.android.com/reference/androidx/media3/session/CommandButton#slots()` to define the allowed button placement.

The buttons are converted to platform actions in the platform media session playback state for platform or legacy `android.support.v4.media.session.MediaControllerCompat` controllers (see `
PlaybackStateCompat.Builder#addCustomAction(PlaybackStateCompat.CustomAction)`). When converting, the `https://developer.android.com/reference/androidx/media3/session/SessionCommand#customExtras()` is used for the extras of the platform custom action.

Controllers that connect have the custom layout of the session available with the initial connection result by default. A custom layout specific to a controller can be set when the controller `https://developer.android.com/reference/androidx/media3/session/MediaSession.Callback#onConnectAsync(androidx.media3.session.MediaSession,androidx.media3.session.MediaSession.ControllerInfo)` by using an `https://developer.android.com/reference/androidx/media3/session/MediaSession.ConnectionResult.AcceptedResultBuilder`.

On the controller side, `https://developer.android.com/reference/androidx/media3/session/CommandButton#isEnabled()` is overridden according to the available commands of the controller.

Use `https://developer.android.com/reference/androidx/media3/session/MediaSession#setCustomLayout(androidx.media3.session.MediaSession.ControllerInfo,java.util.List<androidx.media3.session.CommandButton>)` to update the custom layout during the lifetime of the session.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/session/CommandButton> customLayout` | The ordered list of `https://developer.android.com/reference/androidx/media3/session/CommandButton`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | The builder to allow chaining. |

### setExtras

```
public MediaLibraryService.MediaLibrarySession.Builder setExtras(Bundle tokenExtras)
```

Sets an extras `https://developer.android.com/reference/android/os/Bundle.html` for the `https://developer.android.com/reference/androidx/media3/session/MediaSession#getToken()`. If not set, `https://developer.android.com/reference/android/os/Bundle.html#EMPTY` is used.

A controller has access to these extras through the `https://developer.android.com/reference/androidx/media3/session/MediaController#getConnectedToken()`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/os/Bundle.html tokenExtras` | The extras `https://developer.android.com/reference/android/os/Bundle.html`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | The builder to allow chaining. |

### setId

```
public MediaLibraryService.MediaLibrarySession.Builder setId(String id)
```

Sets an ID of the `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. If not set, an empty string will be used.

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-grained controls.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html id` | The ID. Must be unique among all `https://developer.android.com/reference/androidx/media3/session/MediaSession` per package. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | The builder to allow chaining. |

### setLibraryErrorReplicationMode

```
@UnstableApi
@CanIgnoreReturnValue
public MediaLibraryService.MediaLibrarySession.Builder setLibraryErrorReplicationMode(int libraryErrorReplicationMode)
```

Sets whether library result errors should be replicated to the platform media session's `https://developer.android.com/reference/android/media/session/PlaybackState.html` as a fatal error, a non-fatal error or not replicated at all. Replication is only executed for calling legacy browsers (`https://developer.android.com/reference/android/support/v4/media/MediaBrowserCompat` and `https://developer.android.com/reference/android/media/browse/MediaBrowser.html`) to which no error codes can be transmitted as a result of the service call.

The default is `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession#LIBRARY_ERROR_REPLICATION_MODE_NON_FATAL()`.

`https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Callback#onGetLibraryRoot(androidx.media3.session.MediaLibraryService.MediaLibrarySession,androidx.media3.session.MediaSession.ControllerInfo,androidx.media3.session.MediaLibraryService.LibraryParams)` is exempted from replication, because this method is part of the connection process of a legacy browser.

The following error codes are replicated:

- `https://developer.android.com/reference/androidx/media3/session/SessionError#ERROR_SESSION_AUTHENTICATION_EXPIRED()`
- `https://developer.android.com/reference/androidx/media3/session/SessionError#ERROR_SESSION_PREMIUM_ACCOUNT_REQUIRED()`

See `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession#clearReplicatedLibraryError()` also.

| Parameters |
|---|---|
| `int libraryErrorReplicationMode` | The mode to use. |

### setMediaButtonPreferences

```
@CanIgnoreReturnValue
@UnstableApi
public MediaLibraryService.MediaLibrarySession.Builder setMediaButtonPreferences(List<CommandButton> mediaButtonPreferences)
```

Sets the media button preferences.

The button is converted to custom actions in the platform media session playback state for platform or legacy `android.support.v4.media.session.MediaControllerCompat` controllers (see `
PlaybackStateCompat.Builder#addCustomAction(PlaybackStateCompat.CustomAction)`). When converting, the `https://developer.android.com/reference/androidx/media3/session/SessionCommand#customExtras()` is used for the extras of the platform custom action.

Controllers that connect have the media button preferences of the session available with the initial connection result by default. Media button preferences specific to a controller can be set when the controller `https://developer.android.com/reference/androidx/media3/session/MediaSession.Callback#onConnectAsync(androidx.media3.session.MediaSession,androidx.media3.session.MediaSession.ControllerInfo)` by using an `https://developer.android.com/reference/androidx/media3/session/MediaSession.ConnectionResult.AcceptedResultBuilder`.

Use `MediaSession.setMediaButtonPreferences(..)` to update the media button preferences during the lifetime of the session.

On the controller side, the `https://developer.android.com/reference/androidx/media3/session/CommandButton#isEnabled()` flag is set to `false` if the available commands of a controller do not allow to use a button.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/session/CommandButton> mediaButtonPreferences` | The ordered list of `https://developer.android.com/reference/androidx/media3/session/CommandButton`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | The builder to allow chaining. |

### setPackageNameOverride

```
@UnstableApi
@CanIgnoreReturnValue
@RequiresPermission(value = "android.permission.OVERRIDE_MEDIA_SESSION_OWNER")
public MediaLibraryService.MediaLibrarySession.Builder setPackageNameOverride(String packageNameOverride)
```

Overrides the package name of the session created.

This method must not be used if the provided `packageNameOverride` is same as the package name of the application creating the session.

Interoperability: The value set by this method is ignored on API levels below 37 for legacy sessions and controllers.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html packageNameOverride` | The package name override of the session when created. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | This builder. |

### setPeriodicPositionUpdateEnabled

```
@UnstableApi
public MediaLibraryService.MediaLibrarySession.Builder setPeriodicPositionUpdateEnabled(boolean isEnabled)
```

Sets whether periodic position updates should be sent to controllers while playing. If false, no periodic position updates are sent to controllers.

The default is `true`.

| Parameters |
|---|---|
| `boolean isEnabled` | Whether periodic position update is enabled. |

### setSessionActivity

```
public MediaLibraryService.MediaLibrarySession.Builder setSessionActivity(PendingIntent pendingIntent)
```

Sets a `https://developer.android.com/reference/android/app/PendingIntent.html` to launch an `https://developer.android.com/reference/android/app/Activity.html` for the `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession`. This can be used as a quick link to an ongoing media screen.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/app/PendingIntent.html pendingIntent` | The pending intent. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | The builder to allow chaining. |

### setSessionExtras

```
@UnstableApi
public MediaLibraryService.MediaLibrarySession.Builder setSessionExtras(Bundle sessionExtras)
```

Sets the `https://developer.android.com/reference/androidx/media3/session/MediaSession#getSessionExtras()`. If not set, `https://developer.android.com/reference/android/os/Bundle.html#EMPTY` is used.

A controller has access to session extras through `https://developer.android.com/reference/androidx/media3/session/MediaController#getSessionExtras()`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/os/Bundle.html sessionExtras` | The session extras `https://developer.android.com/reference/android/os/Bundle.html`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/session/MediaLibraryService.MediaLibrarySession.Builder` | The builder to allow chaining. |

### setShowPlayButtonIfPlaybackIsSuppressed

```
@UnstableApi
public MediaLibraryService.MediaLibrarySession.Builder setShowPlayButtonIfPlaybackIsSuppressed(
    boolean showPlayButtonIfPlaybackIsSuppressed
)
```

Sets whether a play button is shown if playback is `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackSuppressionReason()`.

The default is `true`.

| Parameters |
|---|---|
| `boolean showPlayButtonIfPlaybackIsSuppressed` | Whether to show a play button if playback is `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackSuppressionReason()`. |

## Protected methods

### ensureBitmapLoaderIsSizeLimited

```
@EnsuresNonNull(value = "bitmapLoader")
protected final void ensureBitmapLoaderIsSizeLimited()
```

Updates bitmap loader to ensure its using the maximum media session size limit.