AbstractPlayerFragment

The shared PlayerView host that owns all player state and view references.

The underlying androidx.media3.ui.PlayerView widget (named to avoid conflict with our PlayerView).

Safer activity?.onBackPressedDispatcher?.onBackPressed() with fallback behavior instead of app crash

Player fragments don't need system-bar padding adjustment by default.

Returns whether the player UI (controls overlay) is currently visible.

NOTE: Only one observer at a time per value

Attaches an observable to the root binding, instead of the fragment. This is more efficient as it will not call observe if the view is in the background.

Called when the auto-hide timer fires: UI is showing, no touch is active. Implement to hide the player controls.

Called when the binding is safely created and view is ready. Overload without savedInstanceState for convenience.

Called when the binding is safely created and view is ready. Can be overridden to provide fragment-specific initialization.

Called during brightness swipe with the current extra-brightness alpha (0–1).

Called when the device configuration changes (e.g., orientation). Re-applies system bar padding fixes to the root view to ensure it readjusts for orientation changes.

Cleans up the binding reference when the view is destroyed to avoid memory leaks.

Called at the end of each touch sequence.

Called when a swipe gesture begins; hide the player UI if desired.

Called when the hold-for-speedup gesture starts (show=true) or ends (show=false).

Called with seek-preview text during a horizontal-swipe, or null to clear it.

Called on a short single-tap on empty player area (no swipe, no double-tap).

Called on a valid ACTION_DOWN; use for e.g. dismissing an episode overlay.

Called after the fragment's view has been created.

Pick a layout resource ID for the fragment.

Delegates to PlayerView.playerError by default; override to customize.

Called after PlayerView finishes its own player-attached setup (MediaSession, ExoPlayer view).