AppOpenAdPreloader

Kotlin |Java

public final class AppOpenAdPreloader

---

Wstępne wczytywanie reklam wyświetlanych przy otwarciu aplikacji.

Podsumowanie

Metody publiczne
static boolean	destroy(String preloadId) Przerywa wstępne wczytywanie w przypadku danego elementu preloadId i usuwa wszystkie powiązane wstępnie wczytane reklamy.
static void	destroyAll() Zatrzymuje wstępne wczytywanie i usuwa wstępnie wczytane reklamy we wszystkich konfiguracjach wstępnego wczytywania.
static @Nullable PreloadConfiguration	getConfiguration(String preloadId) Zwraca reklamę wyświetlaną przy otwarciu aplikacji PreloadConfiguration powiązaną z tym preloadId lub wartość null, jeśli taka reklama nie istnieje.
static Map<String, PreloadConfiguration>	getConfigurations() Zwraca mapę wszystkich PreloadConfigurationreklam w aplikacji, których kluczem jest powiązany identyfikator wstępnego wczytywania.
static int	getNumAdsAvailable(String preloadId) Zwraca liczbę dostępnych reklam dla danego identyfikatora wstępnego wczytywania.
static boolean	isAdAvailable(String preloadId) Określa, czy dla danego preloadId jest dostępna co najmniej jedna reklama.
static @Nullable AppOpenAd	pollAd(String preloadId) Zwraca reklamę wstępnie wczytaną z start lub start i usuwa ją z pamięci podręcznej.
static boolean	start(String preloadId, PreloadConfiguration preloadConfiguration) Rozpoczyna wstępne wczytywanie reklam dla podanych wartości preloadId i PreloadConfiguration.
static boolean	start(     String preloadId,     PreloadConfiguration preloadConfiguration,     PreloadCallbackV2 preloadCallback ) Rozpoczyna wstępne wczytywanie reklam dla podanych wartości preloadId, PreloadConfiguration i PreloadCallbackV2.

Metody publiczne

zniszczyć

public static boolean destroy(String preloadId)

Przerywa wstępne wczytywanie w przypadku danego elementu preloadId i usuwa wszystkie powiązane wstępnie wczytane reklamy.

Parametry
String preloadId	Identyfikator wstępnego wczytywania konfiguracji do usunięcia.

Zwroty
boolean	true, jeśli aktywna konfiguracja wstępnego wczytywania została zniszczona. Zwraca wartość false, jeśli dla danego parametru preloadId nie ma aktywnej konfiguracji wstępnego wczytywania.

destroyAll

public static void destroyAll()

Zatrzymuje wstępne wczytywanie i usuwa wstępnie wczytane reklamy we wszystkich konfiguracjach wstępnego wczytywania.

getConfiguration

public static @Nullable PreloadConfiguration getConfiguration(String preloadId)

Zwraca reklamę wyświetlaną przy otwarciu aplikacji PreloadConfiguration powiązaną z tym preloadId lub wartość null, jeśli taka reklama nie istnieje.

Parametry
String preloadId	Identyfikator wstępnego wczytywania połączony z tą konfiguracją.

Zwroty
@Nullable PreloadConfiguration	Wartość PreloadConfiguration dla danego identyfikatora wstępnego wczytywania lub null, jeśli nie ma konfiguracji dla danego identyfikatora wstępnego wczytywania.

getConfigurations

public static Map<String, PreloadConfiguration> getConfigurations()

Zwraca mapę wszystkich PreloadConfigurationreklam w aplikacji, których kluczem jest powiązany identyfikator wstępnego wczytywania.

Zwroty
Map<String, PreloadConfiguration>	Konfiguracje reklam wyświetlanych przy otwarciu aplikacji lub pusta mapa, jeśli nie ma wstępnie wczytanych reklam.

getNumAdsAvailable

public static int getNumAdsAvailable(String preloadId)

Zwraca liczbę dostępnych reklam dla danego identyfikatora wstępnego wczytywania.

Parametry
String preloadId	Identyfikator wstępnego ładowania, którego dostępność chcesz sprawdzić.

Zwroty
int	Liczba dostępnych reklam dla danego identyfikatora wstępnego wczytywania.

isAdAvailable

public static boolean isAdAvailable(String preloadId)

Określa, czy dla danego preloadId jest dostępna co najmniej jedna reklama.

Parametry
String preloadId	Identyfikator wstępnego ładowania, którego dostępność chcesz sprawdzić.

Zwroty
boolean	true jeśli dla danego identyfikatora wstępnego wczytywania jest dostępna reklama, false w przeciwnym razie.

pollAd

public static @Nullable AppOpenAd pollAd(String preloadId)

Zwraca reklamę wstępnie wczytaną z start lub start i usuwa ją z pamięci podręcznej.

Pamiętaj, że może to być dowolna z reklam wstępnie wczytanych dla preloadId. Kolejność zwróconych wydarzeń nie musi być zgodna z kolejnością wydarzeń onAdPreloaded.

Parametry
String preloadId	Identyfikator wstępnego wczytywania reklamy.

Zwroty
@Nullable AppOpenAd	Reklama wyświetlana przy otwarciu aplikacji o podanym identyfikatorze wstępnego wczytywania lub null, jeśli żadna reklama nie jest dostępna.

rozpocznij

public static boolean start(String preloadId, PreloadConfiguration preloadConfiguration)

Rozpoczyna wstępne wczytywanie reklam dla podanych wartości preloadId i PreloadConfiguration.

Pakiet SDK kontynuuje wstępne wczytywanie reklam, dopóki nie osiągnie liczby określonej przez getBufferSize, starając się utrzymać pełny bufor przez całą sesję.

Jeśli PreloadConfiguration zostało już uruchomione za pomocą preloadId, ta metoda nie wykonuje żadnych działań i zwraca false.

Parametry
String preloadId	Identyfikator w postaci ciągu znaków dla tego PreloadConfiguration. Użyj tego identyfikatora podczas wywoływania funkcji pollAd, aby uzyskać reklamę dla tej konfiguracji.
PreloadConfiguration preloadConfiguration	Konfiguracja wstępnego wczytywania reklam.

Zwroty
boolean	true – jeśli wstępne wczytywanie zostało rozpoczęte, false – jeśli identyfikator wstępnego wczytywania jest używany.

rozpocznij

public static boolean start(
    String preloadId,
    PreloadConfiguration preloadConfiguration,
    PreloadCallbackV2 preloadCallback
)

Rozpoczyna wstępne wczytywanie reklam dla podanych wartości preloadId, PreloadConfiguration i PreloadCallbackV2.

Pakiet SDK kontynuuje wstępne wczytywanie reklam, dopóki nie osiągnie liczby określonej przez getBufferSize, starając się utrzymać pełny bufor przez całą sesję.

W przypadku każdego żądania reklamy pakiet SDK wywołuje wywołanie zwrotne onAdPreloaded po udanym wstępnym wczytaniu lub wywołanie zwrotne onAdFailedToPreload, jeśli wstępne wczytywanie się nie powiedzie. Pakiet SDK automatycznie ponawia nieudane żądania.

Jeśli PreloadConfiguration już się rozpoczęło z użyciem danego preloadId, ta metoda nie robi nic i zwraca false. staje się operacją bez efektu i zwraca wartość false.

Parametry
String preloadId	Ciąg znaków, który jednoznacznie identyfikuje ten PreloadConfiguration. Użyj tego identyfikatora podczas wywoływania funkcji pollAd, aby pobrać wstępnie wczytaną reklamę dla tej konfiguracji.
PreloadConfiguration preloadConfiguration	Konfiguracja określająca sposób wstępnego wczytywania reklam.
PreloadCallbackV2 preloadCallback	Wywołanie zwrotne, które ma zostać wywołane, gdy zmieni się dostępność reklamy w przypadku danego PreloadConfiguration.

Zwroty
boolean	true – jeśli wstępne wczytywanie zostało rozpoczęte, false – jeśli identyfikator wstępnego wczytywania jest używany.