Player

@UnstableApi
@Composable
fun Player(player: Player?, modifier: Modifier = Modifier): Unit

A composable that provides a basic player UI layout with default controls and a shutter.

This composable consists of a ContentFrame that handles the rendering of the player's video, overlaid with default button controls, progress slider, and a shutter.

This component uses the standard Material3 layouts provided by PlayerDefaults. This includes PlayerDefaults.TopControls, PlayerDefaults.CenterControls, and PlayerDefaults.BottomControls.

To customize the UI components, use the overload that accepts these as parameters.

@ExperimentalApi
@Composable
fun Player(
    player: Player?,
    modifier: Modifier = Modifier,
    surfaceType: @SurfaceType Int = SURFACE_TYPE_SURFACE_VIEW,
    contentScale: ContentScale = ContentScale.Fit,
    keepContentOnReset: Boolean = false,
    shutter: @Composable () -> Unit = PlayerDefaults::Shutter,
    showControls: Boolean = false,
    topControls: (@Composable BoxScope.(Player?, Boolean) -> Unit)? = { player, showControls ->
    PlayerDefaults.TopControls(player, showControls, Modifier.fillMaxWidth())
  },
    centerControls: (@Composable BoxScope.(Player?, Boolean) -> Unit)? = { player, showControls ->
    PlayerDefaults.CenterControls(player, showControls, Modifier.fillMaxWidth())
  },
    bottomControls: (@Composable BoxScope.(Player?, Boolean) -> Unit)? = { player, showControls ->
    PlayerDefaults.BottomControls(player, showControls)
  },
    errorOverlay: (@Composable BoxScope.(Player?) -> Unit)? = { PlayerDefaults.ErrorOverlay(it) }
): Unit

A composable that provides a basic player UI layout, combining a ContentFrame for displaying player content with customizable controls and a shutter.

This composable is designed to be a flexible container for building player interfaces. It consists of a ContentFrame that handles the rendering of the player's video, overlaid with optional controls and a shutter.

By default, this component uses the standard Material3 layouts provided by PlayerDefaults. This includes PlayerDefaults.TopControls, PlayerDefaults.CenterControls, and PlayerDefaults.BottomControls. You can deeply customize the player UI by providing your own composables to the slots of this composable, or by utilizing the PlayerDefaults layouts and overriding only specific slots within them.

The Player natively manages keyboard focus traversal between its control slots. Each provided control slot (topControls, centerControls, and bottomControls) is wrapped in a focus group. 1-dimensional focus traversal (e.g., using the Tab key) is configured to move sequentially from the top controls, to the center controls, and down to the bottom controls. Backward traversal moves in the reverse order.