Pra-pengambilan Live Stream

IMA SDK dapat digunakan untuk memonetisasi live stream serta video on demand. Untuk live stream, Anda harus membuat permintaan iklan baru untuk setiap jeda iklan. Sesuaikan permintaan ini untuk memastikan semua penonton Anda tidak mengajukan permintaan iklan pada saat yang sama dan memperlambat server iklan.

Untuk membantu melakukan tugas ini, IMA SDK memiliki AdsRequest.liveStreamPrefetchSeconds saat ini. Properti ini menentukan jumlah detik maksimum SDK harus menunggu sebelum menghubungi server iklan setelah Anda memanggil AdsLoader.requestAds(). Waktu permintaan sebenarnya akan diacak. Sebagai misalnya, jika Anda menetapkan AdsRequest.liveStreamPrefetchSeconds ke 30, SDK menunggu 0 hingga 30 detik setelah Anda memanggil AdsLoader.requestAds() untuk membuat permintaan ke server.

Praktik pengambilan awal live stream

Sebaiknya lakukan pengambilan data jeda iklan berikutnya segera setelah jeda iklan selesai. Hal ini memastikan durasi waktu maksimum tersedia untuk periode pra-pengambilan Anda. Misalkan Anda memiliki jeda 5 menit di antara jeda iklan. Saat jeda iklan selesai, Anda dapat meminta jeda iklan berikutnya dengan periode pra-pengambilan selama 290 detik (5 menit dikurangi 10 detik, untuk memastikan permintaan dikirim pada akhir jendela pra-pengambilan memiliki cukup waktu untuk diselesaikan):

Cuplikan kode ini menunjukkan cara menambahkan pengambilan awal live stream ke Contoh Lanjutan , namun pendekatan tersebut dapat diterapkan pada penerapan IMA lainnya.

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);
}