Composable Function

rememberAmbientModeManager

Creates, remembers, and manages the lifecycle of the default [AmbientModeManager] implementation.

rememberAmbientModeManager

Android
@Composable
public fun rememberAmbientModeManager(): AmbientModeManager

Creates, remembers, and manages the lifecycle of the default AmbientModeManager implementation.

**This function requires a LocalActivity be present and automatically enables Always-On mode for that activity, ensuring it remains visible in the low-power ambient state.**

The resulting AmbientModeManager is retained across recompositions via remember and its system listeners are automatically registered and unregistered using DisposableEffect, tying the ambient tracking to the composition lifecycle.

See the Android documentation for more details on enabling Always-On mode: https://developer.android.com/training/wearables/views/always-on

Example of a simple screen switching between Interactive and Ambient modes:

Returns

A new or remembered AmbientModeManager instance.