การดึงข้อมูลสตรีมแบบสดล่วงหน้า

คุณสามารถใช้ IMA SDK เพื่อสร้างรายได้จากสตรีมแบบสดและวิดีโอออนดีมานด์ สำหรับสตรีมแบบสด คุณจะต้องสร้างคำขอโฆษณาใหม่สำหรับช่วงพักโฆษณาแต่ละครั้ง จำกัดคำขอเหล่านี้เพื่อให้แน่ใจว่าผู้ชมทุกคนจะไม่ขอโฆษณาพร้อมกันและพยายามเรียกใช้เซิร์ฟเวอร์โฆษณา

IMA SDK จึงมีพร็อพเพอร์ตี้ AdsRequest.liveStreamPrefetchSeconds เพื่อช่วยในเรื่องนี้ พร็อพเพอร์ตี้นี้ระบุจำนวนวินาทีสูงสุดที่ SDK ควรรอก่อนที่จะติดต่อเซิร์ฟเวอร์โฆษณาหลังจากที่คุณเรียกใช้ AdsLoader.requestAds() เวลาส่งคำขอจริงจะสุ่มมาเป็น ตัวอย่างเช่น หากคุณตั้งค่า AdsRequest.liveStreamPrefetchSeconds เป็น 30 SDK จะรอ 0 ถึง 30 วินาทีหลังจากที่คุณเรียกใช้ AdsLoader.requestAds() เพื่อส่งคำขอไปยังเซิร์ฟเวอร์จริง

การดึงข้อมูลล่วงหน้าของสตรีมแบบสดในทางปฏิบัติ

เราขอแนะนำให้ดึงข้อมูลช่วงพักโฆษณาถัดไปล่วงหน้าทันทีที่ช่วงพักโฆษณาสิ้นสุดลง วิธีนี้ช่วยให้มั่นใจได้ว่ากรอบเวลาการดึงข้อมูลล่วงหน้าจะมีระยะเวลาสูงสุด สมมติว่าคุณมีเวลา 5 นาทีระหว่างช่วงพักโฆษณา เมื่อช่วงพักโฆษณาทำงานเสร็จแล้ว คุณขอช่วงพักโฆษณาถัดไปได้โดยใช้กรอบเวลาการดึงข้อมูลล่วงหน้าเป็น 290 วินาที (5 นาที - 10 วินาที เพื่อให้มั่นใจว่าคำขอที่ส่งเมื่อสิ้นสุดกรอบเวลาการดึงข้อมูลล่วงหน้ามีเวลาเพียงพอในการแก้ไข)

ประเด็นสำคัญ: คู่มือเริ่มต้นใช้งาน และตัวอย่างพื้นฐาน ใช้ส่วนขยาย Exoplayer-IMA ซึ่งจัดการการตั้งค่า AdsManager ทั้งคู่ ด้วยเหตุนี้ ระบบจึงไม่สามารถ ใช้ทรัพยากรเหล่านี้เป็นจุดเริ่มต้นสำหรับคู่มือนี้ เราขอแนะนำให้ใช้ตัวอย่างขั้นสูงเป็นจุดเริ่มต้นสำหรับการดึงข้อมูลล่วงหน้าของสตรีมแบบสด

ข้อมูลโค้ดเหล่านี้แสดงวิธีเพิ่มการดึงข้อมูลล่วงหน้าของสตรีมแบบสดลงในตัวอย่างขั้นสูง แต่วิธีการนี้ใช้กับการใช้งาน IMA อื่นๆ ได้

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