admob-cmp-core/dev.avinya.ads/FullScreenAdController

FullScreenAdController

interface FullScreenAdController(source)

Controls a full-screen ad format (interstitial, rewarded, rewarded interstitial, or app-open). Full-screen ads are single-use: show consumes the ad. Successfully presented rewarded ads deliberately remain callback-owned after dismissal so a mediated reward callback may arrive later. Cache and TTL are managed by AdCachePolicy.

Inheritors

InterstitialAdController

RewardedAdController

RewardedInterstitialAdController

AppOpenAdController

Properties

abstract val events: SharedFlow<AdEvent>

Shared flow of full-screen ad lifecycle events.

abstract val loadState: StateFlow<AdLoadState>

Current load state.

abstract val placement: AdPlacement

The placement this controller is bound to.

Functions

abstract fun availability(): AdAvailability

Returns current availability info (cached count, expiry).

abstract fun clear()

Clears cached ads and releases resources.

open fun isReady(): Boolean

True when at least one cached ad is ready to show.

abstract suspend fun load(requestOptions: AdRequestOptions = placement.requestOptions): AdLoadState

Loads an ad. Suspends until the load completes.

open suspend fun preload(requestOptions: AdRequestOptions = placement.requestOptions): AdLoadState

Alias for load.

abstract suspend fun show(options: FullScreenAdOptions = placement.fullScreenOptions): AdShowResult

Shows the ad. Suspends until the ad is dismissed and returns AdShowResult.