กําลังโหลดสื่อไว้ล่วงหน้า

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

วิชาบังคับก่อน

การโหลดล่วงหน้าต้องใช้ IMA Android SDK เวอร์ชัน 3.17.0 ขึ้นไป

เปิดใช้การโหลดล่วงหน้า

หากต้องการเปิดใช้การโหลดล่วงหน้า ให้ใช้ AdsRenderingSettings.setEnablePreloading() เพื่อตั้งค่าการโหลดล่วงหน้าเป็น "จริง" ซึ่งต้องดำเนินการภายใน onAdsManagerLoaded() การเรียกกลับ:

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent adsManagerLoadedEvent) {
  ...
  AdsRenderingSettings adsRenderingSettings =
      ImaSdkFactory.getInstance().createAdsRenderingSettings();
  adsRenderingSettings.setEnablePreloading(true);
  mAdsManager.init(adsRenderingSettings);
}

การรองรับการโหลดล่วงหน้าด้วย VideoAdPlayer ที่กําหนดเอง

เราขอแนะนําส่วนขยาย ExoPlayer-IMA ที่ใช้ในแอปตัวอย่าง ExoPlayer ของ Android เมื่อผสานรวมแล้ว ส่วนขยาย ExoPlayer-IMA จะเปิดใช้การโหลดล่วงหน้าโดยค่าเริ่มต้น และมีการรองรับการโหลดล่วงหน้าในตัว

หากคุณใช้การโหลดล่วงหน้าโดยไม่มีส่วนขยาย ExoPlayer-IMA คุณจะต้องทําการเปลี่ยนแปลงเพิ่มเติมเมื่อเรียกใช้ setEnablePreloading() วิดีโอเพลเยอร์ต้องติดตามออบเจ็กต์ AdMediaInfo ที่ส่งผ่านในการเรียกใช้จาก loadAd() และ playAd() และใส่ AdMediaInfo ที่ถูกต้องในการเรียกใช้ AdPlayerCallback จึงจะรองรับการโหลดโฆษณาล่วงหน้าได้ ซึ่งอาจต้องใช้โครงสร้างข้อมูลเพื่อจัดการออบเจ็กต์ AdMediaInfo เนื่องจาก loadAd() สำหรับ AdMediaInfo รายการถัดไปอาจเกิดขึ้นขณะที่ AdMediaInfo รายการก่อนหน้ากำลังเล่นอยู่ ตัวอย่างต่อไปนี้แสดงการเปลี่ยนแปลงบางอย่างที่คุณอาจต้องทำเพื่อให้แอปรองรับการโหลดล่วงหน้า

// enum for cases of PlayerState.
static enum PlayerState {
  IDLE,
  LOADED,
  PLAYING,
  PAUSED,
}

...

private final List<VideoAdPlayer.VideoAdPlayerCallback> callbacks;
private final ArrayList<AdMediaInfo> mediaInfos = new ArrayList<>();
private PlayerState playerState;
private boolean adCurrentlyLoaded;

...

@Override
public void playAd(AdMediaInfo adMediaInfo) {
  switch (playerState) {
    case LOADED:
      for (VideoAdPlayerCallback callback : callbacks) {
        callback.onPlay(adMediaInfo);
      }
      break;
    case PAUSED:
      for (VideoAdPlayerCallback callback : callbacks) {
        callback.onResume(adMediaInfo);
      }
      break;
    case PLAYING:
      // Intentionally and silently ignore since it is already playing from a prior media item,
      // note that onPlay is triggered by positionDiscontinuity.
      return;
    case IDLE:
      throw new IllegalStateException("Call to playAd when player state is not LOADED.");
  }
  playerState = PlayerState.PLAYING;
  player.setPlayWhenReady(true);
}

@Override
public void loadAd(AdMediaInfo adMediaInfo, AdPodInfo adPodInfo) {
  if (adCurrentlyLoaded == true) {
    mediaInfos.add(adMediaInfo);
    return;
  }
  player.stop();
  player.seekTo(0);
  mediaInfos.clear();
  mediaInfos.add(adMediaInfo);
  player.setPlayWhenReady(false);
  player.loadMedia(adMediaInfo.getUrl());
  playerState = PlayerState.LOADED;
  adCurrentlyLoaded = true;
}

@Override
public void stopAd(AdMediaInfo adMediaInfo) {
  if (allAdsInBreakHavePlayed()) {
    if (isFinalAd(adMediaInfo)) {
      // handle clean up after all ads have played.
    } else {
      seekToNextItem(player);
    }
  } else {
    mediaInfos.remove(adMediaInfo);
  }
}

private boolean allAdsInBreakHavePlayed() {
  // Code to determine if all the ads in the current ad break have completed.
}

private boolean isFinalAd(AdMediaInfo adMediaInfo) {
  // Code to determine if this adMediaInfo is the final ad.
}

private void seekToNextItem(YourPlayerClass player) {
  // Code to seek your player to the next media item.
}

การทดสอบการติดตั้งใช้งานการโหลดล่วงหน้าที่กำหนดเอง

สําหรับการติดตั้งใช้งานการโหลดล่วงหน้าที่กําหนดเอง เราขอแนะนําให้ทดสอบกรณีขอบเขตต่อไปนี้เพื่อยืนยันว่าการตั้งค่าการโหลดล่วงหน้าถูกต้อง

• โฆษณาตอนต้นแบบโฆษณาเดียว
• โฆษณาตอนต้นในพ็อดโฆษณา 3 รายการ
• โฆษณาตอนกลางในพ็อดโฆษณา 3 รายการ
• การกรอไปยังโฆษณาตอนกลางรายการที่ 2 หลังจากที่โฆษณาตอนกลางรายการแรกเริ่มโหลดล่วงหน้าแล้วแต่ยังไม่ได้เล่น
• การเล่นตอนท้าย

ช่วงเวลา

ตารางต่อไปนี้สรุปการเปลี่ยนแปลงของเวลาในการโหลดโฆษณาเมื่อเปิดใช้การโหลดล่วงหน้า

กิจกรรม	มีระบบโหลดล่วงหน้า	โดยไม่ต้องโหลดล่วงหน้า
VAST ของโฆษณาที่ขอ	AdsLoader.requestAds()	AdsLoader.requestAds()
โฆษณาตอนต้นโหลดแล้ว (โฆษณาเดียว)	AdsManager.init()	AdsManager.start()
โฆษณาตอนต้นโหลดแล้ว (VMAP/กฎโฆษณา)	AdsManager.init()	AdsManager.init()
โฆษณาตอนกลางหรือตอนท้ายโหลด	สำหรับโฆษณาที่ 1 ในช่วงพักโฆษณา ให้แสดงก่อนเวลาเริ่มต้นของโฆษณา 8 วินาที สําหรับโฆษณาที่แสดงต่อเนื่องกัน เมื่อโฆษณาก่อนหน้าเริ่มเล่น	เมื่อถึงเวลาเริ่มต้นโฆษณา

คำถามที่พบบ่อย

การโหลดสื่อล่วงหน้าจะโหลดครีเอทีฟโฆษณาทั้งรายการไหม

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

จำเป็นต้องเปิดใช้การโหลดสื่อล่วงหน้าสำหรับ VAST ของโฆษณาและสื่อด้วยไหม

ไม่ SDK จะโหลด VAST ของโฆษณาไว้ล่วงหน้าเสมอ ไม่ว่าจะตั้งค่าการโหลดล่วงหน้าหรือไม่ก็ตาม