setStatusBarCovered

open fun setStatusBarCovered(statusBarCovered: Boolean): ModalRichmediaConfig

Sets whether modal in-app messages should cover the status bar area.

When enabled, modals can extend into the status bar area for a more immersive experience. This is particularly effective for fullscreen modals or when you want maximum visual impact. Consider the status bar content visibility when using this option.

API Level Considerations: This setting primarily applies to API 34 and below, where edge-to-edge behavior is not enforced by default. For API 35+, use setRespectEdgeToEdgeLayout instead. Example:


// Immersive fullscreen experience for video or rich content
ModalRichmediaConfig immersiveConfig = new ModalRichmediaConfig()
    .setViewPosition(ModalRichMediaViewPosition.FULLSCREEN)
    .setStatusBarCovered(true)
    .setRespectEdgeToEdgeLayout(true);

// Standard modal that respects system UI (uses defaults)
ModalRichmediaConfig standardConfig = new ModalRichmediaConfig();

// Top-positioned modal that integrates with status bar
ModalRichmediaConfig integratedConfig = new ModalRichmediaConfig()
    .setViewPosition(ModalRichMediaViewPosition.TOP)
    .setStatusBarCovered(true);

Return

this configuration instance for method chaining

Parameters

statusBarCovered

true to cover the status bar, false to respect it, defaults to false if not specified