setContinuousPlayback()
השיטה מודיעה ל-SDK אם הנגן מתכוון להפעיל את סרטוני התוכן ברצף, בדומה לשידור בטלוויזיה. כשהערך מוגדר ל-true, המודעות שמוחזרות מהבקשה הן אלה ששרת המודעות הגדיר כמתאימות להפעלה רציפה. אם לא קוראים לשיטה הזו, ההגדרה נשארת לא ידועה.
בדוגמה הבאה אפשר לראות איך מגדירים הפעלה רציפה בבקשה להצגת מודעות.
AdsRequest request = mSdkFactory.createAdsRequest(); request.setAdTagUrl(adTagUrl); request.setContinuousPlayback(true); adsLoader.requestAds(request);
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_my); playerView = findViewById(R.id.player_view); ImaAdsLoader.Builder builder = new ImaAdsLoader.Builder(this).setContinuousPlayback(true); adsLoader = builder.build(); }
מה ההבדל בין הפעלה רציפה לבין הפעלה אוטומטית של מודעות
IMA SDK ל-Android מאפשר גם לקבוע אם הנגן יתחיל להפעיל את הסרטון באופן אוטומטי או ימתין לפעולת משתמש כדי להתחיל בהפעלה. הפעולה הזו מתבצעת באמצעות השיטה
setAdWillAutoPlay(). אם הערך מוגדר כ-true, המודעות שמוחזרות הן אלה ששרת המודעות הגדיר כמתאימות לסביבת הפעלה אוטומטית.
בטבלה הזו מפורט מתי צריך לשלוח בקשות להצגת מודעות להפעלה רציפה ולהפעלה אוטומטית, על סמך תוכן הווידאו שאליו משויכות המודעות.
| תוכן וידאו | פרמטר ל-setContinuousPlayback() | פרמטר ל-setAdWillAutoPlay() |
|---|---|---|
| סרטון תוכן יחיד שמופעל אחרי אינטראקציה של המשתמש | false |
false |
| סרטון תוכן יחיד שמופעל אוטומטית | false |
true |
| פלייליסט של סרטונים שבו הסרטון הראשון מופעל אחרי אינטראקציה של המשתמש, אבל הסרטונים הבאים מופעלים אוטומטית | true |
false |
| פלייליסט של סרטונים שבו הסרטון הראשון מופעל אוטומטית וגם הסרטונים הבאים מופעלים אוטומטית | true |
true |