MediationBannerAdapter

Kotlin |Java

interface MediationBannerAdapter : MediationAdapter

Adapter do zewnętrznych sieci reklamowych obsługujących banery reklamowe.

Typowy cykl życia adaptera polega na jednokrotnym wywołaniu funkcji requestBannerAd. Na tym etapie adapter powinien poprosić sieć reklamową o reklamę i powiadomić odbiorcę o tym, czy reklama została wczytana (onAdLoaded), czy nie (onAdFailedToLoad). Kolejne żądania będą wysyłane z nową instancją adaptera. Pod koniec cyklu życia podejmujemy wszelkie starania, aby wywołać funkcję onDestroy, ale nie możemy tego zagwarantować. Pamiętaj, że funkcja requestBannerAd jest wywoływana w wątku interfejsu, więc obowiązują wszystkie standardowe środki ostrożności związane z pisaniem kodu w tym wątku. W szczególności kod nie powinien wywoływać żadnych metod blokujących.

Adapter powinien udostępniać zdarzenia za pomocą obiektu MediationBannerListener przekazanego w wywołaniu requestBannerAd. Wszystkie parametry niezbędne do wysłania żądania reklamy powinny być przekazywane w parametrach serverParameters, MediationAdRequest i mediationExtras.

Adaptery powinny dążyć do wyłączenia automatycznego odświeżania reklam po stronie klienta. Odświeżane reklamy mogą być ignorowane, nie wyświetlane i nieprawidłowo zliczane.

Podsumowanie

Funkcje publiczne
`View!`	`getBannerView()` Zwraca obiekt `View`, który można wyrenderować, aby wyświetlić reklamę.
`Unit`	`requestBannerAd( context: Context!, listener: MediationBannerListener!, serverParameters: Bundle!, adSize: AdSize!, mediationAdRequest: MediationAdRequest!, mediationExtras: Bundle? )` Wywoływana przez bibliotekę zapośredniczenia w celu wysłania do adaptera żądania reklamy banerowej.

Funkcje dziedziczone

Z com.google.android.gms.ads.mediation.MediationAdapter

`Unit`	`onDestroy()` Rozbiera element sterujący adaptera.
`Unit`	`onPause()` Wywoływana, gdy aplikacja wywołuje funkcję `onPause` na obiekcie `com.google.android.gms.ads.AdView`.
`Unit`	`onResume()` Wywoływana, gdy aplikacja wywołuje funkcję `onResume` na obiekcie `com.google.android.gms.ads.AdView`.

Funkcje publiczne

getBannerView

fun getBannerView(): View!

Zwraca obiekt View, który można wyrenderować, aby wyświetlić reklamę.

Po wywołaniu funkcji requestBannerAd i przed wywołaniem funkcji onDestroy nie może mieć wartości null. W innych przypadkach może mieć wartość null.

requestBannerAd

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

Wywoływana przez bibliotekę zapośredniczenia w celu wysłania do adaptera żądania reklamy banerowej.

Jeśli żądanie zostanie wykonane, powinna zostać wywołana metoda onAdLoaded.

Jeśli żądanie się nie powiedzie, w obiekcie listener należy wywołać metodę onAdFailedToLoad z odpowiednią przyczyną błędu.

Ta metoda jest wywoływana w wątku interfejsu, więc obowiązują wszystkie standardowe środki ostrożności dotyczące pisania kodu w tym wątku. W szczególności kod nie powinien wywoływać żadnych metod blokujących.

Parametry
`context: Context!`	`Context` elementu AdView, który będzie zawierać widok banera. Preferowany jest atrybut `android.app.Activity`.
`listener: MediationBannerListener!`	Detektor do adaptera z wywołaniami zwrotnymi dla różnych zdarzeń
`serverParameters: Bundle!`	Dodatkowe parametry zdefiniowane przez wydawcę po stronie serwera mediacji
`adSize: AdSize!`	Rozmiar reklamy do pobrania. Zwrócony rozmiar reklamy powinien być jak najbardziej zbliżony do rozmiaru określonego w tym parametrze. Jeśli ten rozmiar reklamy nie jest obsługiwany, żądanie powinno się zakończyć niepowodzeniem i należy wywołać funkcję onAdFailedToLoad.
`mediationAdRequest: MediationAdRequest!`	Ogólne parametry, których wydawca może używać podczas wysyłania żądania reklamy
`mediationExtras: Bundle?`	Dodatkowe parametry ustawiane przez wydawcę w przypadku każdego żądania