VideoController

public final class VideoController


אובייקט שמספק שליטה בהפעלה של מודעות וידאו.

סיכום

סוגי עץ

קריאה חוזרת לקבלת עדכונים על אירועים במחזור החיים של מודעות וידאו.

שיטות ציבוריות

@Nullable VideoController.VideoLifecycleCallbacks

הפונקציה מחזירה את VideoLifecycleCallbacks שסופק בעבר, או ערך null אם לא סופק מופע.

boolean

הפונקציה מחזירה את הערך true אם במודעה הנוכחית יש תוכן וידאו.

boolean

הפונקציה מחזירה את הערך true אם מודעת הווידאו משתמשת בהתנהגות 'קליק כדי להרחיב'.

boolean

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

boolean

הפונקציה מחזירה את הערך true אם הסרטון מושתק כרגע, ואת הערך false במקרים אחרים.

void
mute(boolean mute)

מגדירה את מצב ההשתקה של הווידאו.

void

השהיה של מודעת הווידאו, אם רלוונטי.

void

מפעילים את מודעת הווידאו, אם רלוונטי.

void

הגדרת מאזין שיקבל קריאות חוזרות (callbacks) לאירועי וידאו.

void

הפסקת ההפעלה של הסרטון.

שיטות ציבוריות

getVideoLifecycleCallbacks

public @Nullable VideoController.VideoLifecycleCallbacks getVideoLifecycleCallbacks()

הפונקציה מחזירה את VideoLifecycleCallbacks שסופק בעבר, או ערך null אם לא סופק מופע.

hasVideoContent

public boolean hasVideoContent()

הפונקציה מחזירה את הערך true אם במודעה הנוכחית יש תוכן וידאו.

isClickToExpandEnabled

public boolean isClickToExpandEnabled()

הפונקציה מחזירה את הערך true אם מודעת הווידאו משתמשת בהתנהגות 'קליק כדי להרחיב'.

isCustomControlsEnabled

public boolean isCustomControlsEnabled()

הפונקציה מחזירה את הערך true אם מודעת הווידאו משתמשת בלחצני שליטה מותאמים אישית בנגן. אם משתמשים בפקדי נגן בהתאמה אישית, האחריות של האפליקציה היא לספק פקדי הפעלה/השהיה והשתקה/ביטול השהיה, ולקרוא ל-play, ל-pause ול-mute בזמנים המתאימים.

משתמשים ב-setCustomControlsRequested כדי להפעיל פקדים מותאמים אישית.

בשלב זה, אמצעי הבקרה בהתאמה אישית זמינים רק להזמנות ב-Ad Manager.

isMuted

public boolean isMuted()

הפונקציה מחזירה את הערך true אם הסרטון מושתק כרגע, ואת הערך false במקרים אחרים.

השתקה

public void mute(boolean mute)

מגדירה את מצב ההשתקה של הווידאו.

שיטת הבקרה הזו של הסרטון פועלת רק כש-isCustomControlsEnabled מחזירה את הערך true.

פרמטרים
boolean mute

true אם צריך להשתיק את הסרטון, false אם לא

השהיה

public void pause()

השהיה של מודעת הווידאו, אם רלוונטי. אם הסרטון כבר הושהה או הסתיים, השיטה הזו לא תפעל.

שיטת הבקרה הזו של הסרטון פועלת רק כש-isCustomControlsEnabled מחזירה את הערך true.

הפעלה

public void play()

מפעילים את מודעת הווידאו, אם רלוונטי. אם הסרטון כבר מופעל, השיטה הזו לא מבצעת פעולה כלשהי.

שיטת הבקרה הזו של הסרטון פועלת רק כש-isCustomControlsEnabled מחזירה את הערך true.

setVideoLifecycleCallbacks

public void setVideoLifecycleCallbacks(
    @Nullable VideoController.VideoLifecycleCallbacks callbacks
)

הגדרת מאזין שיקבל קריאות חוזרות (callbacks) לאירועי וידאו.

פרמטרים
@Nullable VideoController.VideoLifecycleCallbacks callbacks

האובייקט שיקבל קריאות חוזרות במחזור החיים

stop

public void stop()

הפסקת ההפעלה של הסרטון. שיחות חוזרות אל play ימשיכו בתחילת הסרטון. אם הסרטון כבר הופסק, השיטה הזו לא תפעל.

כדי שאפשר יהיה להשתמש ב-API הזה, יחידת המודעות צריכה להיכלל ברשימת ההיתרים. אם אתם רוצים להשתמש בתכונה הזו, פנו למנהל החשבון שלכם.