الجلب المسبق للبث المباشر

يمكن استخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لتحقيق ربح من أحداث البث المباشر والفيديوهات عند الطلب. بالنسبة إلى أحداث البث المباشر، عليك تقديم طلب إعلان جديد لكل فاصل إعلاني. يمكنك ترتيب هذه الطلبات للتأكّد من أنّ جميع المشاهدين لا يطلبون الإعلانات في الوقت نفسه وأنّهم يعيقون أداء خوادم الإعلانات.

للمساعدة في ذلك، تحتوي حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على السمة AdsRequest.liveStreamPrefetchSeconds. تحدّد هذه السمة الحد الأقصى لعدد الثواني التي يجب أن تنتظرها حزمة SDK قبل الوصول إلى خادم الإعلانات بعد طلب البيانات AdsLoader.requestAds(). سيتم توزيع وقت الطلب الفعلي عشوائيًا. على سبيل المثال، في حال ضبط AdsRequest.liveStreamPrefetchSeconds على 30، تنتظر حزمة SDK مدة تتراوح بين 0 و30 ثانية بعد استدعاء AdsLoader.requestAds() لإرسال الطلب إلى الخادم.

التطبيق العملي على الجلب المُسبَق للبث المباشر

ننصحك بجلب الفاصل الإعلاني التالي مسبقًا فور اكتماله. يضمن ذلك الحدّ الأقصى لطول مدة نافذة الجلب المسبق. لنفرض أنّ هناك 5 دقائق بين الفواصل الإعلانية. عند اكتمال الفاصل الإعلاني، يمكنك طلب الفاصل الإعلاني التالي باستخدام نافذة للجلب المسبق تبلغ 290 ثانية (5 دقائق ناقص 10 ثوانٍ، للتأكد من أنّ الطلبات المرسَلة في نهاية نافذة الجلب المسبق لديها وقت كافٍ للحلّ):

نقطة رئيسية: يستخدم كلٌّ من دليل البدء والمثال الأساسي إضافة Exoplayer-IMA التي تعالج عملية إعداد AdsManager. لهذا السبب، لا يمكن استخدام هذه الموارد كنقطة بداية لهذا الدليل. ننصحك باستخدام المثال المتقدّم كنقطة بداية للجلب المسبق للبث المباشر.

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

VideoPlayerController.java

/** Ads logic for handling the IMA SDK integration code and events. */
public class VideoPlayerController {

  // 5 minutes == 300 seconds. Include a 10 second buffer
  private float AD_INTERVAL = 290;
  private double AD_TIMEOUT = 300;

...

  adsManager.addAdEventListener(
    new AdEvent.AdEventListener() {
      /** Responds to AdEvents. */
      @Override
      public void onAdEvent(AdEvent adEvent) {

      ...

      case ALL_ADS_COMPLETED:
        if (adsManager != null) {
          adsManager.destroy();
          adsManager = null;
        }

        // When pre-fetching for live streams, be sure to destroy the current AdsManager,
        // in case the tag you requested previously contains post-rolls
        // (you don't want to play those now).

        // Pre-fetch the next ad break.
        // Play those ads in ~5 minutes. In a real-world implementation,
        // this will likely be done as the result of a message from your
        // streaming server, not a via the playAdsAfterThisTime parameter
        // of requestAndPlayAds().
        requestAndPlayAds(AD_TIMEOUT);
        break;
      default:
        break;
      }
  }

...

public void requestAndPlayAds(double playAdsAfterThisTime) {
  if (currentAdTagUrl == null || currentAdTagUrl == "") {
    log("No VAST ad tag URL specified");
    resumeContent();
    return;
  }

  // Since you're switching to a new video, tell the SDK the previous video is finished.
  if (adsManager != null) {
    adsManager.destroy();
  }

  playButton.setVisibility(View.GONE);

  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(currentAdTagUrl);
  request.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());
  request.setLiveStreamPrefetchSeconds(AD_INTERVAL);

  playAdsAfterTime = playAdsAfterThisTime;

  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}