InterstitialAdPreloader

Kotlin |Java

class InterstitialAdPreloader

---

רכיב הטעינה מראש של מודעות מעברון.

סיכום

פונקציות ציבוריות
java-static Boolean	destroy(preloadId: String!) הפעולה הזו מפסיקה את הטעינה מראש של preloadId הנתון ומוחקת את כל המודעות שנטענו מראש שמשויכות אליו.
java-static Unit	destroyAll() הפונקציה מפסיקה את הטעינה מראש ומשמידה מודעות שנטענו מראש בכל הגדרות הטעינה מראש.
java-static PreloadConfiguration?	getConfiguration(preloadId: String!) הפונקציה הזו יצאה משימוש. אין תחליף.
java-static (Mutable)Map<String!, PreloadConfiguration!>!	getConfigurations() הפונקציה הזו יצאה משימוש. אין תחליף.
java-static Int	getNumAdsAvailable(preloadId: String!) הפונקציה מחזירה את מספר המודעות שזמינות למזהה הטעינה מראש שצוין.
java-static Boolean	isAdAvailable(preloadId: String!) הפונקציה קובעת אם יש לפחות מודעה אחת שזמינה ל-preloadId שצוין.
java-static InterstitialAd?	pollAd(preloadId: String!) מחזירה מודעה שנטענה מראש מ-start או מ-start ומסירה אותה מהמטמון.
java-static Boolean	start(preloadId: String!, preloadConfiguration: PreloadConfiguration!) מתחיל לטעון מראש מודעות עבור הערכים שצוינו של preloadId ו-PreloadConfiguration.
java-static Boolean	start(     preloadId: String!,     preloadConfiguration: PreloadConfiguration!,     preloadCallback: PreloadCallbackV2! ) מתחיל לטעון מראש מודעות עבור preloadId, PreloadConfiguration ו-.

פונקציות ציבוריות

כיבוי סופי

java-static fun destroy(preloadId: String!): Boolean

הפעולה הזו מפסיקה את הטעינה מראש של preloadId הנתון ומוחקת את כל המודעות שנטענו מראש שמשויכות אליו.

פרמטרים
preloadId: String!	מזהה הטעינה מראש של ההגדרה שרוצים להסיר.

החזרות
Boolean	‫true אם הושמד מערך פעיל של הגדרות אישיות לטעינה מראש. הפונקציה מחזירה false אם אין הגדרת טעינה מראש פעילה עבור preloadId הנתון.

destroyAll

java-static fun destroyAll(): Unit

הפונקציה מפסיקה את הטעינה מראש ומשמידה מודעות שנטענו מראש בכל הגדרות הטעינה מראש.

getConfiguration

java-static fun getConfiguration(preloadId: String!): PreloadConfiguration?

הפונקציה הזו יצאה משימוש.

אין תחליף.

הפונקציה מחזירה את המודעה המתגמלת PreloadConfiguration שמשויכת ל- preloadId הזה, או null אם לא קיימת מודעה כזו.

פרמטרים
preloadId: String!	מזהה הטעינה מראש שמקושר לתצורה הזו.

החזרות
PreloadConfiguration?	הערך PreloadConfiguration למזהה הטעינה מראש שצוין, או null אם אין הגדרה למזהה הטעינה מראש שצוין.

getConfigurations

java-static fun getConfigurations(): (Mutable)Map<String!, PreloadConfiguration!>!

הפונקציה הזו יצאה משימוש.

אין תחליף.

הפונקציה מחזירה מפה של כל מודעות הביניים PreloadConfiguration, עם מפתח לפי מזהה הטעינה מראש המשויך.

החזרות
(Mutable)Map<String!, PreloadConfiguration!>!	ההגדרות של המודעות הביניים, או מפה ריקה אם לא קיימים טוענים מראש.

getNumAdsAvailable

java-static fun getNumAdsAvailable(preloadId: String!): Int

הפונקציה מחזירה את מספר המודעות שזמינות למזהה הטעינה מראש שצוין.

פרמטרים
preloadId: String!	מזהה הטעינה מראש שרוצים לבדוק את הזמינות שלו.

החזרות
Int	מספר המודעות שזמינות למזהה הטעינה מראש שצוין.

isAdAvailable

java-static fun isAdAvailable(preloadId: String!): Boolean

הפונקציה קובעת אם יש לפחות מודעה אחת שזמינה ל-preloadId שצוין.

פרמטרים
preloadId: String!	מזהה הטעינה מראש שרוצים לבדוק את הזמינות שלו.

החזרות
Boolean	‫true אם יש מודעה זמינה למזהה הטעינה מראש שצוין, false אחרת.

pollAd

java-static fun pollAd(preloadId: String!): InterstitialAd?

מחזירה מודעה שנטענה מראש מ-start או מ-start ומסירה אותה מהמטמון.

שימו לב: יכול להיות שזו תהיה כל אחת מהמודעות שנטענו מראש עבור preloadId. אין ערובה לכך שהסדר של ההזמנות שיוחזרו יהיה זהה לסדר של אירועי onAdPreloaded.

פרמטרים
preloadId: String!	המזהה של הטעינה מראש של המודעה.

החזרות
InterstitialAd?	מודעת מעברון עם מזהה הטעינה מראש שצוין, או null אם אין מודעה זמינה.

start

java-static fun start(preloadId: String!, preloadConfiguration: PreloadConfiguration!): Boolean

מתחילות לטעון מראש מודעות עבור הערכים שצוינו של preloadId ו-PreloadConfiguration.

ה-SDK ממשיך לטעון מראש מודעות עד שמגיעים למספר המודעות שצוין על ידי getBufferSize, בניסיון לשמור על מאגר המודעות מלא לאורך כל הסשן.

אם PreloadConfiguration כבר הופעל עם preloadId, השיטה הזו לא מבצעת פעולה ומחזירה false.

פרמטרים
preloadId: String!	מזהה מחרוזת של PreloadConfiguration. משתמשים במזהה הזה כשמתקשרים אל pollAd כדי לקבל מודעה להגדרה הזו.
preloadConfiguration: PreloadConfiguration!	ההגדרה של טעינה מראש של מודעות.

החזרות
Boolean	‫true if preloading started, false if the preloadId is in-use.

start

java-static fun start(
    preloadId: String!,
    preloadConfiguration: PreloadConfiguration!,
    preloadCallback: PreloadCallbackV2!
): Boolean

מתחיל לטעון מראש מודעות עבור preloadId, PreloadConfiguration ו-.

ה-SDK ממשיך לטעון מראש מודעות עד שמגיעים למספר המודעות שצוין על ידי getBufferSize, בניסיון לשמור על מאגר המודעות מלא לאורך כל הסשן.

לכל בקשה להצגת מודעה, ה-SDK מפעיל קריאה חוזרת (callback) מסוג onAdPreloaded אם הטעינה מראש הצליחה, או קריאה חוזרת מסוג onAdFailedToPreload אם הטעינה מראש נכשלה. ה-SDK מנסה שוב באופן אוטומטי בקשות שנכשלו.

אם PreloadConfiguration כבר התחיל עם preloadId הנתון, השיטה הזו לא עושה כלום ומחזירה false. הופכת לפעולה שלא עושה כלום ומחזירה false.

פרמטרים
preloadId: String!	מחרוזת שמזהה באופן ייחודי את PreloadConfiguration. משתמשים במזהה הזה כשקוראים ל-pollAd כדי לאחזר מודעה שנטענה מראש עבור ההגדרה הזו.
preloadConfiguration: PreloadConfiguration!	ההגדרה שקובעת איך המודעות נטענות מראש.
preloadCallback: PreloadCallbackV2!	פונקציית קריאה חוזרת שמופעלת כשזמינות המודעה משתנה עבור PreloadConfiguration.

החזרות
Boolean	‫true if preloading started, false if the preloadId is in-use.