VideoController
class VideoController
عنصر يوفّر عناصر التحكّم في تشغيل إعلانات الفيديو.
ملخّص
الأنواع المتداخلة |
|---|
abstract class VideoController.VideoLifecycleCallbacksدالة ردّ الاتصال لتلقّي إشعارات بشأن أحداث دورة حياة إعلانات الفيديو. |
الوظائف العامة |
|
|---|---|
VideoController.VideoLifecycleCallbacks? |
تعرِض هذه السمة |
Boolean |
تعرض القيمة "صحيح" إذا كان الإعلان الحالي يتضمّن محتوى فيديو. |
Boolean |
تعرض القيمة "صحيح" إذا كان إعلان الفيديو يستخدم سلوك النقر للتوسيع. |
Boolean |
تعرض القيمة true إذا كان الإعلان على الفيديو يستخدم عناصر تحكّم مخصّصة في المشغّل. |
Boolean |
isMuted()تعرض هذه السمة القيمة "صحيح" إذا كان الفيديو مكتومًا حاليًا، والقيمة "خطأ" في الحالات الأخرى. |
Unit |
تضبط هذه السمة حالة كتم صوت الفيديو. |
Unit |
pause()توقِف هذه الطريقة إعلان الفيديو مؤقتًا، إذا كان ذلك منطبقًا. |
Unit |
play()تشغيل إعلان الفيديو إذا كان ذلك منطبقًا |
Unit |
تضبط هذه الطريقة أداة معالجة ستتلقّى عمليات رد الاتصال لأحداث الفيديو. |
Unit |
stop()توقِف تشغيل الفيديو. |
الوظائف العامة
getVideoLifecycleCallbacks
fun getVideoLifecycleCallbacks(): VideoController.VideoLifecycleCallbacks?
تعرِض هذه السمة VideoLifecycleCallbacks المقدَّمة سابقًا أو قيمة فارغة إذا لم يتم تقديم أي مثيل.
hasVideoContent
fun hasVideoContent(): Boolean
تعرض القيمة "صحيح" إذا كان الإعلان الحالي يتضمّن محتوى فيديو.
isClickToExpandEnabled
fun isClickToExpandEnabled(): Boolean
تعرض القيمة "صحيح" إذا كان إعلان الفيديو يستخدم سلوك النقر للتوسيع.
isCustomControlsEnabled
fun isCustomControlsEnabled(): Boolean
تعرض القيمة true إذا كان الإعلان على الفيديو يستخدم عناصر تحكّم مخصّصة في المشغّل. في حال استخدام عناصر تحكّم مخصّصة في المشغّل، يكون التطبيق مسؤولاً عن توفير عناصر التحكّم في التشغيل/الإيقاف المؤقت والكتم/إلغاء الكتم، واستدعاء play وpause وmute في الأوقات المناسبة.
استخدِم setCustomControlsRequested لتفعيل عناصر التحكّم المخصّصة.
لا تتوفّر عناصر التحكّم المخصّصة حاليًا إلا للحجوزات في "مدير إعلانات Google".
isMuted
fun isMuted(): Boolean
تعرض هذه السمة القيمة "صحيح" إذا كان الفيديو مكتومًا حاليًا، والقيمة "خطأ" في الحالات الأخرى.
كتم الصوت
fun mute(mute: Boolean): Unit
تضبط هذه السمة حالة كتم صوت الفيديو.
لا تعمل طريقة التحكّم في الفيديو هذه إلا عندما تعرض isCustomControlsEnabled القيمة "صحيح".
| المعلمات | |
|---|---|
mute: Boolean |
صحيح إذا كان يجب كتم صوت الفيديو، خطأ إذا كان يجب إعادة صوت الفيديو |
pause
fun pause(): Unit
توقِف هذه الطريقة إعلان الفيديو مؤقتًا، إذا كان ذلك منطبقًا. لا تؤدي هذه الطريقة أي إجراء إذا كان الفيديو متوقفًا مؤقتًا أو انتهى.
لا تعمل طريقة التحكّم في الفيديو هذه إلا عندما تعرض isCustomControlsEnabled القيمة "صحيح".
تشغيل
fun play(): Unit
تشغيل إعلان الفيديو إذا كان ذلك منطبقًا لا يؤدي هذا الإجراء إلى أي تغيير إذا كان الفيديو قيد التشغيل.
لا تعمل طريقة التحكّم في الفيديو هذه إلا عندما تعرض isCustomControlsEnabled القيمة "صحيح".
setVideoLifecycleCallbacks
fun setVideoLifecycleCallbacks(
callbacks: VideoController.VideoLifecycleCallbacks?
): Unit
تضبط هذه الطريقة أداة معالجة ستتلقّى عمليات رد الاتصال لأحداث الفيديو.
| المعلمات | |
|---|---|
callbacks: VideoController.VideoLifecycleCallbacks? |
الكائن الذي سيتلقّى عمليات الاستدعاء في إحدى مراحل النشاط |
إيقاف
fun stop(): Unit
توقِف تشغيل الفيديو. ستستأنف المكالمات اللاحقة إلى play من بداية الفيديو. لا يتم تنفيذ هذه الطريقة إذا تم إيقاف الفيديو من قبل.
يجب أن تكون الوحدة الإعلانية في القائمة المسموح بها لتتمكّن من استخدام واجهة برمجة التطبيقات هذه. إذا كنت مهتمًا باستخدام هذه الميزة، يُرجى التواصل مع مدير حسابك.