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