VideoController

Kotlin |Java

class VideoController

---

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

סיכום

סוגי עץ
abstract class VideoController.VideoLifecycleCallbacks קריאה חוזרת לקבלת עדכונים על אירועים במחזור החיים של מודעות וידאו.

פונקציות ציבוריות
VideoController.VideoLifecycleCallbacks?	getVideoLifecycleCallbacks() הפונקציה מחזירה את VideoLifecycleCallbacks שסופק קודם לכן, או ערך null אם לא סופקה מופע.
Boolean	hasVideoContent() הפונקציה מחזירה את הערך true אם במודעה הנוכחית יש תוכן וידאו.
Boolean	isClickToExpandEnabled() הפונקציה מחזירה את הערך true אם מודעת הווידאו משתמשת בהתנהגות 'קליק כדי להרחיב'.
Boolean	isCustomControlsEnabled() הפונקציה מחזירה את הערך true אם מודעת הווידאו משתמשת בלחצני שליטה מותאמים אישית בנגן.
Boolean	isMuted() הפונקציה מחזירה את הערך true אם הסרטון מושתק כרגע, ואת הערך false במקרים אחרים.
Unit	mute(mute: Boolean) מגדירה את מצב ההשתקה של הווידאו.
Unit	pause() השהיה של מודעת הווידאו, אם רלוונטי.
Unit	play() מפעילים את מודעת הווידאו, אם רלוונטי.
Unit	setVideoLifecycleCallbacks(     callbacks: VideoController.VideoLifecycleCallbacks? ) הגדרת מאזין שיקבל קריאות חוזרות (callbacks) לאירועי וידאו.
Unit	stop() הפסקת ההפעלה של הסרטון.

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

getVideoLifecycleCallbacks

fun getVideoLifecycleCallbacks(): VideoController.VideoLifecycleCallbacks?

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

hasVideoContent

fun hasVideoContent(): Boolean

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

isClickToExpandEnabled

fun isClickToExpandEnabled(): Boolean

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

isCustomControlsEnabled

fun isCustomControlsEnabled(): Boolean

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

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

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

isMuted

fun isMuted(): Boolean

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

השתקה

fun mute(mute: Boolean): Unit

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

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

פרמטרים
mute: Boolean	true אם צריך להשתיק את הסרטון, false אם לא

השהיה

fun pause(): Unit

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

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

הפעלה

fun play(): Unit

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

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

setVideoLifecycleCallbacks

fun setVideoLifecycleCallbacks(
    callbacks: VideoController.VideoLifecycleCallbacks?
): Unit

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

פרמטרים
callbacks: VideoController.VideoLifecycleCallbacks?	האובייקט שיקבל קריאות חוזרות במחזור החיים

stop

fun stop(): Unit

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

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