CustomEventBanner

Kotlin |Java

public interface CustomEventBanner extends CustomEvent

支援橫幅廣告的自訂事件。

自訂事件的一般生命週期是呼叫 requestBannerAd 一次。此時，轉接程式應建立 android.view.View，並向 onAdLoaded 或 onAdFailedToLoad 回報。後續要求會使用自訂事件的新例項。在生命週期結束時，系統會盡力呼叫 onDestroy，但不保證一定能成功。請注意，requestBannerAd 會在 UI 執行緒上呼叫，因此在該執行緒上編寫程式碼時，必須採取所有標準的預防措施。具體來說，程式碼不應呼叫任何阻斷方法。

轉接器應透過 requestBannerAd 呼叫中傳遞的 CustomEventBannerListener 公開事件。請在 serverParameter、MediationAdRequest 和 customEventExtras 參數中傳遞所有廣告請求所需的參數。

摘要

公用方法
`abstract void`	`requestBannerAd( Context context, CustomEventBannerListener listener, @Nullable String serverParameter, AdSize size, MediationAdRequest mediationAdRequest, @Nullable Bundle customEventExtras )` 由中介資料程式庫呼叫，用於從自訂事件要求檢視畫面。

繼承方法

來自 com.google.android.gms.ads.mediation.customevent.CustomEvent

`abstract void`	`onDestroy()` 拆解轉接器控制項。
`abstract void`	`onPause()` 在應用程式呼叫 `pause` 時呼叫。
`abstract void`	`onResume()` 在應用程式呼叫 `resume` 時呼叫。

公用方法

requestBannerAd

abstract void requestBannerAd(
    Context context,
    CustomEventBannerListener listener,
    @Nullable String serverParameter,
    AdSize size,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

由中介資料程式庫呼叫，用於從自訂事件要求檢視畫面。

如果要求成功，應呼叫 onAdLoaded。

如果要求失敗，請在 listener 上呼叫 onAdFailedToLoad，並提供適當的錯誤原因。

此方法會在 UI 執行緒上呼叫，因此會套用在該執行緒上編寫程式碼的所有標準預防措施。特別是，您的程式碼不應呼叫任何封鎖方法。

參數
`Context context`	AdView 的 `Context`，其中包含自訂事件。建議使用 `android.app.Activity`。
`CustomEventBannerListener listener`	自訂事件的監聽器，可用於各種事件的回呼。
`@Nullable String serverParameter`	在發布商使用者介面中設定的字串，做為自訂事件的參數。
`AdSize size`	要擷取的檢視畫面大小。檢視畫面的大小應盡可能與此參數中指定的大小相近。如果系統不支援這個檢視畫面大小，要求應會失敗，並且應呼叫 onAdFailedToLoad。
`MediationAdRequest mediationAdRequest`	請在要求檢視畫面時使用一般指定目標參數。
`@Nullable Bundle customEventExtras`	發布商針對個別要求設定的參數 `Bundle`。