کنترلکننده ویدئو
class VideoController
شیءای که کنترل پخش را برای تبلیغات ویدیویی فراهم میکند.
خلاصه
انواع تو در تو |
|---|
abstract class VideoController.VideoLifecycleCallbacksبرای دریافت بهروزرسانیها در مورد رویدادهای چرخه عمر تبلیغات ویدیویی، با ما تماس بگیرید. |
کارکردهای عمومی | |
|---|---|
VideoController.VideoLifecycleCallbacks ? | |
Boolean | اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، مقدار true را برمیگرداند. |
Boolean | اگر تبلیغ ویدیویی از رفتار کلیک برای باز شدن استفاده کند، مقدار true را برمیگرداند. |
Boolean | اگر تبلیغ ویدیویی از کنترلهای پخشکنندهی سفارشی استفاده کند، مقدار true را برمیگرداند. |
Boolean | isMuted ()اگر ویدیو در حال حاضر بیصدا باشد، مقدار true و در غیر این صورت مقدار false را برمیگرداند. |
Unit | وضعیت بیصدا کردن ویدیو را تنظیم میکند. |
Unit | pause ()در صورت لزوم، تبلیغ ویدیویی را متوقف میکند. |
Unit | play ()در صورت لزوم، تبلیغ ویدیویی را پخش کنید. |
Unit | setVideoLifecycleCallbacks (شنوندهای را تنظیم میکند که فراخوانیهای رویدادهای ویدیویی را دریافت میکند. |
Unit | stop ()پخش ویدیو را متوقف میکند. |
کارکردهای عمومی
فراخوانیهای برگشتی چرخه عمر ویدیو (getVideoLifecycleCallbacks)
fun getVideoLifecycleCallbacks(): VideoController.VideoLifecycleCallbacks?
VideoLifecycleCallbacks قبلاً ارائه شده را برمیگرداند یا اگر نمونهای ارائه نشده باشد، null است.
محتوای ویدیویی دارد
fun hasVideoContent(): Boolean
اگر تبلیغ فعلی محتوای ویدیویی داشته باشد، مقدار true را برمیگرداند.
فعالسازیشده برای باز کردن (isClickToExpandEnabled)
fun isClickToExpandEnabled(): Boolean
اگر تبلیغ ویدیویی از رفتار کلیک برای باز شدن استفاده کند، مقدار true را برمیگرداند.
isCustomControlsEnabled
fun isCustomControlsEnabled(): Boolean
اگر تبلیغ ویدیویی از کنترلهای پخشکنندهی سفارشی استفاده کند، مقدار true را برمیگرداند. اگر از کنترلهای پخشکنندهی سفارشی استفاده شود، وظیفهی برنامه است که کنترلهای پخش/مکث و بیصدا/وصل صدا را ارائه دهد و در زمانهای مناسب play ، pause و mute فراخوانی کند.
برای فعال کردن کنترلهای سفارشی setCustomControlsRequested استفاده کنید.
کنترلهای سفارشی در حال حاضر فقط برای رزروهای مدیر تبلیغات در دسترس هستند.
خاموش شده
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: VideoController.VideoLifecycleCallbacks ? | شیءای که قرار است فراخوانیهای چرخه حیات را دریافت کند |
متوقف کردن
fun stop(): Unit
پخش ویدیو را متوقف میکند. فراخوانیهای بعدی برای play ، از ابتدای ویدیو از سر گرفته میشوند. اگر ویدیو قبلاً متوقف شده باشد، این روش بیاثر است.
واحد تبلیغاتی باید در لیست مجاز باشد تا بتواند از این API استفاده کند. اگر به استفاده از این ویژگی علاقهمند هستید، با مدیر حساب خود تماس بگیرید.