VideoController
public final class VideoController
عنصر يقدّم عناصر تحكّم في تشغيل إعلانات الفيديو
ملخّص
الأنواع المتداخلة |
|---|
public abstract class VideoController.VideoLifecycleCallbacksتذكير لتلقّي آخر المعلومات عن أحداث دورة حياة إعلانات الفيديو |
الطرق العامة |
|
|---|---|
@Nullable VideoController.VideoLifecycleCallbacks |
تعرِض القيمة |
boolean |
تعرِض هذه السمة القيمة "صحيح" إذا كان الإعلان الحالي يتضمّن محتوى فيديو. |
boolean |
تعرِض قيمة صحيحة إذا كان إعلان الفيديو يستخدم سلوك النقر للتوسيع. |
boolean |
تعرِض هذه السمة القيمة true إذا كان الإعلان على الفيديو يستخدم عناصر تحكّم مخصّصة في المشغّل. |
boolean |
isMuted()تعرِض هذه الدالة القيمة true إذا كان الصوت في الفيديو مُسكتًا حاليًا، وتعرِض القيمة false في الحالات الأخرى. |
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()
تعرِض هذه الدالة القيمة true إذا كان الصوت في الفيديو مُسكتًا حاليًا، وتعرِض القيمة false في الحالات الأخرى.
كتم الصوت
public void mute(boolean mute)
لضبط حالة كتم الصوت في الفيديو.
لا تعمل طريقة التحكّم في الفيديو هذه إلا عندما يعرض isCustomControlsEnabled القيمة true.
| المعلمات | |
|---|---|
boolean mute |
صحيح إذا كان يجب كتم صوت الفيديو، وخطأ إذا كان الصوت مفعّلاً |
pause
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 في بداية الفيديو. لا يمكنك استخدام هذه الطريقة إذا سبق أن تم إيقاف الفيديو.
يجب أن تكون الوحدة الإعلانية مُدرَجة في قائمة المسموح بها لكي تتمكّن من استخدام واجهة برمجة التطبيقات هذه. إذا كنت مهتمًا باستخدام هذه الميزة، يُرجى التواصل مع مدير حسابك.