MediationBannerAdapter

Kotlin |Java

public interface MediationBannerAdapter extends MediationAdapter

適用於支援橫幅廣告的第三方廣告聯播網的轉接器。

轉接器的生命週期通常是呼叫 requestBannerAd 一次。此時，轉接程式應向廣告聯播網要求廣告，並向監聽器回報 onAdLoaded 或 onAdFailedToLoad。後續要求會使用轉接程式的新例項提出。在生命週期結束時，系統會盡力呼叫 onDestroy，但不保證一定能成功。請注意，requestBannerAd 會在 UI 執行緒上呼叫，因此在該執行緒上編寫程式碼時，必須採取所有標準的預防措施。具體來說，程式碼不應呼叫任何阻斷方法。

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

轉接程式應盡量停用用戶端的自動廣告重新整理功能。系統可能會忽略、不顯示及錯誤計算已重新整理的廣告。

摘要

公用方法
`abstract View`	`getBannerView()` 傳回可轉譯顯示廣告的 `View`。
`abstract void`	`requestBannerAd( Context context, MediationBannerListener listener, Bundle serverParameters, AdSize adSize, MediationAdRequest mediationAdRequest, @Nullable Bundle mediationExtras )` 由中介服務程式庫呼叫，用於向轉接程式要求橫幅廣告。

繼承方法

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

`abstract void`	`onDestroy()` 拆解轉接器控制項。
`abstract void`	`onPause()` 當應用程式在上呼叫 `onPause` 時，系統會呼叫此方法。
`abstract void`	`onResume()` 當應用程式在上呼叫 `onResume` 時，系統會呼叫此方法。

公用方法

getBannerView

abstract View getBannerView()

傳回可轉譯以顯示廣告的 View。

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

requestBannerAd

abstract void requestBannerAd(
    Context context,
    MediationBannerListener listener,
    Bundle serverParameters,
    AdSize adSize,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

由中介服務程式庫呼叫，用於向轉接程式要求橫幅廣告。

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

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

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

參數
`Context context`	AdView 的 `Context`，其中包含橫幅檢視畫面。建議使用。
`MediationBannerListener listener`	監聽器會向轉接器傳送各種事件的回呼
`Bundle serverParameters`	發布商在中介服務器端定義的其他參數
`AdSize adSize`	要擷取的廣告大小。傳回的廣告大小應盡可能與此參數中指定的大小相近。如果系統不支援這個廣告大小，請要求失敗，並呼叫 onAdFailedToLoad。
`MediationAdRequest mediationAdRequest`	發布商在提出廣告請求時使用的一般參數
`@Nullable Bundle mediationExtras`	發布商針對個別要求設定的其他參數