MediationBannerAdapter

Kotlin |Java

interface MediationBannerAdapter : MediationAdapter

支援橫幅廣告的第三方廣告聯播網專用轉接程式。

轉接程式的典型生命週期是呼叫 requestBannerAd 一次。此時，轉接程式應向廣告聯播網請求廣告，並透過 onAdLoaded 或 onAdFailedToLoad 回報給事件監聽器。後續要求會使用新的轉接程式執行個體。在生命週期結束時，系統會盡力呼叫 onDestroy，但無法保證一定會成功。請注意，requestBannerAd 是在 UI 執行緒上呼叫，因此適用於在該執行緒上編寫程式碼的所有標準預防措施。具體來說，程式碼不應呼叫任何封鎖方法。

介面卡應透過 requestBannerAd 呼叫中傳遞的 MediationBannerListener 公開事件。所有製作廣告請求所需的參數都應傳遞至 serverParameters、MediationAdRequest 和 mediationExtras 參數。

介面卡應盡量在用戶端停用自動重新整理廣告功能。系統可能會忽略重新整理的廣告、不顯示廣告，並錯誤計算廣告。

摘要

公開函式
`View!`	`getBannerView()` 傳回可顯示廣告的 `View`。
`Unit`	`requestBannerAd( context: Context!, listener: MediationBannerListener!, serverParameters: Bundle!, adSize: AdSize!, mediationAdRequest: MediationAdRequest!, mediationExtras: Bundle? )` 中介服務資料庫會呼叫此方法，向轉接程式請求橫幅廣告。

繼承函式

來自 com.google.android.gms.ads.mediation.MediationAdapter

`Unit`	`onDestroy()` 拆除轉接頭控制項。
`Unit`	`onPause()` 應用程式在 `com.google.android.gms.ads.AdView` 上呼叫 `onPause` 時呼叫。
`Unit`	`onResume()` 應用程式在 `com.google.android.gms.ads.AdView` 上呼叫 `onResume` 時呼叫。

公開函式

getBannerView

fun getBannerView(): View!

傳回可顯示廣告的 View。

在 requestBannerAd 呼叫後和 onDestroy 呼叫前，這個值不得為空值。其他時間可能為空值。

requestBannerAd

fun requestBannerAd(
    context: Context!,
    listener: MediationBannerListener!,
    serverParameters: Bundle!,
    adSize: AdSize!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
): Unit

中介服務程式庫會呼叫此方法，向轉接程式請求橫幅廣告。

如果要求成功，系統應會呼叫 onAdLoaded 方法。

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

這個方法會在 UI 執行緒上呼叫，因此請務必遵守在該執行緒上編寫程式碼的所有標準預防措施。具體來說，您的程式碼不應呼叫任何封鎖方法。

參數
`context: Context!`	AdView 的 `Context`，其中會包含橫幅 View。建議使用 `android.app.Activity`。
`listener: MediationBannerListener!`	轉接程式的監聽器，其中包含各種事件的回呼
`serverParameters: Bundle!`	發布商在中介服務伺服器端定義的其他參數
`adSize: AdSize!`	要擷取的廣告大小。傳回的廣告大小應盡可能接近這個參數指定的大小。如果系統不支援這個廣告大小，要求應會失敗，並呼叫 onAdFailedToLoad。
`mediationAdRequest: MediationAdRequest!`	發布商在提出廣告請求時使用的通用參數
`mediationExtras: Bundle?`	發布商針對每項要求設定的其他參數