کنترل‌کننده ویدئو

public final class VideoController


شیء‌ای که کنترل پخش را برای تبلیغات ویدیویی فراهم می‌کند.

خلاصه

انواع تو در تو

برای دریافت به‌روزرسانی‌ها در مورد رویدادهای چرخه عمر تبلیغات ویدیویی، با ما تماس بگیرید.

روش‌های عمومی

@ Nullable VideoController.VideoLifecycleCallbacks

VideoLifecycleCallbacks قبلاً ارائه شده را برمی‌گرداند یا اگر نمونه‌ای ارائه نشده باشد، null است.

boolean

اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، مقدار true را برمی‌گرداند.

boolean

اگر تبلیغ ویدیویی از رفتار کلیک برای باز شدن استفاده کند، مقدار true را برمی‌گرداند.

boolean

اگر تبلیغ ویدیویی از کنترل‌های پخش‌کننده‌ی سفارشی استفاده کند، مقدار true را برمی‌گرداند.

boolean

اگر ویدیو در حال حاضر بی‌صدا باشد، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.

void
mute (boolean mute)

وضعیت بی‌صدا کردن ویدیو را تنظیم می‌کند.

void
pause ()

در صورت لزوم، تبلیغ ویدیویی را متوقف می‌کند.

void
play ()

در صورت لزوم، تبلیغ ویدیویی را پخش کنید.

void

شنونده‌ای را تنظیم می‌کند که فراخوانی‌های رویدادهای ویدیویی را دریافت می‌کند.

void
stop ()

پخش ویدیو را متوقف می‌کند.

روش‌های عمومی

فراخوانی‌های برگشتی چرخه عمر ویدیو (getVideoLifecycleCallbacks)

public @Nullable VideoController.VideoLifecycleCallbacks getVideoLifecycleCallbacks()

VideoLifecycleCallbacks قبلاً ارائه شده را برمی‌گرداند یا اگر نمونه‌ای ارائه نشده باشد، null است.

محتوای ویدیویی دارد

public boolean hasVideoContent()

اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، مقدار true را برمی‌گرداند.

فعال‌سازی‌شده برای باز کردن (isClickToExpandEnabled)

public boolean isClickToExpandEnabled()

اگر تبلیغ ویدیویی از رفتار کلیک برای باز شدن استفاده کند، مقدار true را برمی‌گرداند.

isCustomControlsEnabled

public boolean isCustomControlsEnabled()

اگر تبلیغ ویدیویی از کنترل‌های پخش‌کننده‌ی سفارشی استفاده کند، مقدار true را برمی‌گرداند. اگر از کنترل‌های پخش‌کننده‌ی سفارشی استفاده شود، وظیفه‌ی برنامه است که کنترل‌های پخش/مکث و بی‌صدا/وصل صدا را ارائه دهد و در زمان‌های مناسب play ، pause و mute فراخوانی کند.

برای فعال کردن کنترل‌های سفارشی setCustomControlsRequested استفاده کنید.

کنترل‌های سفارشی در حال حاضر فقط برای رزروهای مدیر تبلیغات در دسترس هستند.

خاموش شده

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
)

شنونده‌ای را تنظیم می‌کند که فراخوانی‌های رویدادهای ویدیویی را دریافت می‌کند.

پارامترها
@ Nullable VideoController.VideoLifecycleCallbacks callbacks

شیء‌ای که قرار است فراخوانی‌های چرخه حیات را دریافت کند

متوقف کردن

public void stop()

پخش ویدیو را متوقف می‌کند. فراخوانی‌های بعدی برای play ، از ابتدای ویدیو از سر گرفته می‌شوند. اگر ویدیو قبلاً متوقف شده باشد، این روش بی‌اثر است.

واحد تبلیغاتی باید در لیست مجاز باشد تا بتواند از این API استفاده کند. اگر به استفاده از این ویژگی علاقه‌مند هستید، با مدیر حساب خود تماس بگیرید.