# rememberPlayPauseButtonState

## Functions summary

|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/ui/compose/state/PlayPauseButtonState` | `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable https://developer.android.com/reference/kotlin/androidx/media3/ui/compose/state/rememberPlayPauseButtonState.composable#rememberPlayPauseButtonState(androidx.media3.common.Player,kotlin.Int)(player: https://developer.android.com/reference/kotlin/androidx/media3/common/Player?, displayMode: @https://developer.android.com/reference/kotlin/androidx/media3/ui/compose/state/DisplayMode https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Remembers the value of `https://developer.android.com/reference/kotlin/androidx/media3/ui/compose/state/PlayPauseButtonState` created based on the passed `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` and launch a coroutine to listen to `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` changes. |

## Functions

### rememberPlayPauseButtonState

Artifact: [androidx.media3:media3-ui-compose](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/ui/compose/state/PlayPauseButtonState.kt+function:rememberPlayPauseButtonState)

```
@UnstableApi
@Composable
fun rememberPlayPauseButtonState(
    player: Player?,
    displayMode: @DisplayMode Int = SHOW_BUFFERING_ALWAYS or SHOW_REPLAY_ON_ENDED or SHOW_RETRY_ON_ERROR
): PlayPauseButtonState
```

Remembers the value of `https://developer.android.com/reference/kotlin/androidx/media3/ui/compose/state/PlayPauseButtonState` created based on the passed `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` and launch a coroutine to listen to `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` changes. If the `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` instance changes between compositions, produce and remember a new value.

| Parameters |
|---|---|
| `player: https://developer.android.com/reference/kotlin/androidx/media3/common/Player?` | The `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` to observe. |
| `displayMode: @https://developer.android.com/reference/kotlin/androidx/media3/ui/compose/state/DisplayMode https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html = SHOW_BUFFERING_ALWAYS or SHOW_REPLAY_ON_ENDED or SHOW_RETRY_ON_ERROR` | The `https://developer.android.com/reference/kotlin/androidx/media3/ui/compose/state/DisplayMode` specifying when to show buffering, replay, or retry. |