VideoController

Kotlin |Java

public final class VideoController

---

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

סיכום

סוגי רכיבים שמוצבים בתוך רכיבים אחרים
public abstract class VideoController.VideoLifecycleCallbacks קריאה חוזרת (callback) לקבלת עדכונים על אירועים במחזור החיים של מודעות וידאו.

‫methods ציבוריות
@Nullable VideoController.VideoLifecycleCallbacks	getVideoLifecycleCallbacks() הפונקציה מחזירה את הערך VideoLifecycleCallbacks שסופק קודם או null אם לא סופק מופע.
boolean	hasVideoContent() הפונקציה מחזירה true אם המודעה הנוכחית מכילה תוכן וידאו.
boolean	isClickToExpandEnabled() הפונקציה מחזירה True אם מודעת הווידאו משתמשת בהתנהגות של לחיצה להרחבה.
boolean	isCustomControlsEnabled() הפונקציה מחזירה true אם במודעת הווידאו נעשה שימוש ברכיבי בקרה מותאמים אישית של הנגן.
boolean	isMuted() הפונקציה מחזירה את הערך true אם הסרטון מושתק כרגע, אחרת היא מחזירה את הערך false.
void	mute(boolean mute) הגדרה של מצב ההשתקה של הווידאו.
void	pause() משהה את מודעת הווידאו, אם רלוונטי.
void	play() מפעילים את מודעת הווידאו אם רלוונטי.
void	setVideoLifecycleCallbacks(     @Nullable VideoController.VideoLifecycleCallbacks callbacks ) מגדירה פונקציית listener שתקבל קריאות חוזרות (callback) לאירועי וידאו.
void	stop() מפסיקה את הפעלת הסרטון.

‫methods ציבוריות

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
)

מגדירה פונקציית listener שתקבל קריאות חוזרות (callback) לאירועי וידאו.

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

עצור

public void stop()

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

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