قبعة سناباك

بصفتك ناشر فيديو، ننصحك بمنع المشاهدين من البحث عن إعلانات أثناء التشغيل. عندما يتجاوز المستخدم الفاصل الإعلاني، يمكنك إعادته إلى بداية الفاصل الإعلاني، ثم إعادته إلى موضع البحث بعد انتهاء الفاصل الإعلاني. تسمى هذه الميزة "snapback".

اطّلع على الرسم التخطيطي أدناه كمثال. يشاهد المُشاهد مقطع فيديو، ويقرر الانتقال من علامة 5 دقائق إلى علامة 15 دقيقة. مع ذلك، هناك فاصل إعلاني عند بلوغ 10 دقائق تريد أن يشاهده المستخدم قبل أن يتمكّن من مشاهدة المحتوى بعد انتهائه:

لعرض هذا الفاصل الإعلاني، يُرجى اتّباع الخطوات التالية:

1. تحقَّق مما إذا كان المستخدم قد نفّذ عملية بحث تتجاوز فاصلاً إعلانيًا لم تتم مشاهدته، وفي هذه الحالة، إعادته إلى الفاصل الإعلاني.
2. بعد اكتمال الفاصل الإعلاني، أعِد عرض الفيديو إلى موضعه الأصلي.

في شكل رسم تخطيطي، يبدو ذلك هكذا:

في ما يلي طريقة تنفيذ سير العمل هذا في حزمة تطوير البرامج لإعلانات الوسائط التفاعلية بتنسيق HTML5، كما هو موضّح في مثال متقدم.

منع التقديم أو الترجيع لفاصل إعلاني بدون مشاهدة

تحقَّق مما إذا كان المستخدم قد أجرى عملية بحث تجاوزت فاصلاً إعلانيًا لم تتم مشاهدته، وفي هذه الحالة، أعِد عرضه إلى الفاصل الإعلاني. في HTML5 SDK، اضبط أداة معالجة حدث في حدث seeked لمشغّل المحتوى لتشغيل onSeekEnd(). تتحقق هذه الطريقة (الواردة أدناه) من نقطة الوقت قبل وقت تقديم المستخدم. وإذا لم يتم تشغيل الفيديو، حاوِل الانتقال إلى بداية الفاصل الإعلاني بدلاً من نقطة التقديم الأولية المطلوبة وحفظ نقطة البحث المطلوبة هذه في snapForwardTime.

function onSeekEnd() {
  if (isLiveStream) { return; }
  if (isSnapback) {
    isSnapback = false;
    return;
  }
  var currentTime = videoElement.currentTime;
  var previousCuePoint =
      streamManager.previousCuePointForStreamTime(currentTime);
  if (previousCuePoint && !previousCuePoint.played) {
    isSnapback = true;
    snapForwardTime = currentTime;
    videoElement.currentTime = previousCuePoint.start;
}

إعادة المستخدم إلى موضعه الأصلي

عندما يظهر لك الآن حدث AD_BREAK_ENDED، تأكّد من أنّه تم ضبط snapForwardTime. إذا كان الأمر كذلك، وجِّه المستخدم إلى هذه المرحلة في البث، لأنّ الفاصل الإعلاني الذي شاهده للتو كان نتيجة استعادة الاتصال:

function onAdBreakEnded(e) {
  videoElement.controls = true;
  clickElement.style.display = 'none';
  adUiDiv.style.display = 'none';
  if (snapForwardTime && snapForwardTime > videoElement.currentTime) {
    videoElement.currentTime = snapForwardTime;
    snapForwardTime = null;
  }
}