สร้างคลาสตัวจัดการโฆษณา

ใน ads_manager.js ให้กำหนดคลาส Wrapper สำหรับ IMA SDK StreamManager ที่สร้างคำขอสตรีม รับไฟล์ Manifest ของพ็อดโฆษณา รอเหตุการณ์สตรีม IMA และส่งเหตุการณ์ emsg ไปยัง IMA SDK

ใน ads_manager.js แอปตัวอย่าง IMA HbbTV จะตั้งค่าเมธอดต่อไปนี้

  • requestStream()
  • onStreamEvent()
  • onEmsgEvent()
  • loadAdPodManifest()

เริ่มต้นใช้งานตัวจัดการโฆษณา

เริ่มต้นใช้งานคลาสตัวจัดการโฆษณาและตั้งค่า Listener สำหรับเหตุการณ์สตรีม IMA ในการเรียกนี้ ให้ตั้งค่าตัวแฮนเดิลเหตุการณ์ emsg ด้วยเมธอด VideoPlayer.setEmsgEventHandler()

/**
 * Wraps IMA SDK ad stream manager.
 * @param {!VideoPlayer} videoPlayer Reference an instance of the wrapper from
 * video_player.js.
 */
var AdManager = function(videoPlayer) {
  this.streamData = null;
  this.videoPlayer = videoPlayer;
  // Ad UI is not supported for HBBTV, so no 'adUiElement' is passed in the
  // StreamManager constructor.
  this.streamManager = new google.ima.dai.api.StreamManager(
      this.videoPlayer.videoElement);
  this.streamManager.addEventListener(
      [
        google.ima.dai.api.StreamEvent.Type.STREAM_INITIALIZED,
        google.ima.dai.api.StreamEvent.Type.ERROR,
        google.ima.dai.api.StreamEvent.Type.CLICK,
        google.ima.dai.api.StreamEvent.Type.STARTED,
        google.ima.dai.api.StreamEvent.Type.FIRST_QUARTILE,
        google.ima.dai.api.StreamEvent.Type.MIDPOINT,
        google.ima.dai.api.StreamEvent.Type.THIRD_QUARTILE,
        google.ima.dai.api.StreamEvent.Type.COMPLETE,
        google.ima.dai.api.StreamEvent.Type.AD_BREAK_STARTED,
        google.ima.dai.api.StreamEvent.Type.AD_BREAK_ENDED,
        google.ima.dai.api.StreamEvent.Type.AD_PROGRESS,
        google.ima.dai.api.StreamEvent.Type.PAUSED,
        google.ima.dai.api.StreamEvent.Type.RESUMED
      ],
      this.onStreamEvent.bind(this),
      false);

  this.videoPlayer.setEmsgEventHandler(this.onEmsgEvent, this);
};

สร้างคำขอสตรีมพ็อดโฆษณา

สร้างเมธอด AdManager.requestStream() เพื่อสร้างออบเจ็กต์ PodStreamRequest โดยใช้รหัสเครือข่าย Ad Manager ของ Google และคีย์เนื้อหาที่กำหนดเองของสตรีม ทดสอบแอป HbbTV โดยใช้สตรีมการแสดงพ็อด DASH ตัวอย่าง IMA ที่มีพารามิเตอร์สตรีมต่อไปนี้

  • รหัสเครือข่าย: '21775744923'
  • คีย์เนื้อหาที่กำหนดเอง: 'hbbtv-dash'
/**
 * Makes a pod stream request.
 * @param {string} networkCode The network code.
 * @param {string} customAssetKey The custom asset key.
 */
AdManager.prototype.requestStream = function (networkCode, customAssetKey) {
  var streamRequest = new google.ima.dai.api.PodStreamRequest();
  var secretKey = getStreamSecretKeys();

  streamRequest.networkCode = networkCode;
  streamRequest.customAssetKey = customAssetKey;
  streamRequest.format = 'dash';

  if (secretKey.STREAM_CREATE_SECRET) {
    var expirationTime = Math.trunc(new Date().getTime() / 1000) + 3600;
    var params = {
      custom_asset_key: customAssetKey,
      exp: expirationTime,
      network_code: networkCode
    };
    streamRequest.authToken =
        this.generateAuthToken(params, secretKey.STREAM_CREATE_SECRET);
    debugView.log('AdsManager: make Auth-PodStreamRequest');
  } else {
    debugView.log('AdsManager: make PodStreamRequest without auth');
  }

  this.streamManager.requestStream(streamRequest);
};

รอเหตุการณ์สตรีมโฆษณา

สร้างเมธอด AdManager.onStreamEvent() เพื่อจัดการการตอบสนองของแอปต่อเหตุการณ์สตรีม IMA, STREAM_INITIALIZED, AD_BREAK_STARTED และ AD_BREAK_ENDED

/**
 * Handles IMA playback events.
 * @param {!Event} event The event object.
 */
AdManager.prototype.onStreamEvent = function(event) {
  switch (event.type) {
    // Once the stream response data is received, generate pod manifest url
    // for the video stream.
    case google.ima.dai.api.StreamEvent.Type.STREAM_INITIALIZED:
      debugView.log('IMA SDK: stream initialized');
      this.streamData = event.getStreamData();
      break;
    case google.ima.dai.api.StreamEvent.Type.ERROR:
      break;
    // Hide video controls while ad is playing.
    case google.ima.dai.api.StreamEvent.Type.AD_BREAK_STARTED:
      debugView.log('IMA SDK: ad break started');
      this.adPlaying = true;
      this.adBreakStarted = true;
      break;
    // Show video controls when ad ends.
    case google.ima.dai.api.StreamEvent.Type.AD_BREAK_ENDED:
      debugView.log('IMA SDK: ad break ended');
      this.adPlaying = false;
      this.adBreakStarted = false;
      break;
    // Update ad countdown timers.
    case google.ima.dai.api.StreamEvent.Type.AD_PROGRESS:
      break;
    default:
      debugView.log('IMA SDK: ' + event.type);
      break;
  }
};

จัดการข้อมูลเมตาของสตรีมโฆษณา

หากต้องการส่งข้อมูลเหตุการณ์ emsg ไปยัง IMA ให้สร้างเมธอด AdManager.onEmsgEvent() โดยใช้เมธอด StreamManager.processMetadata() คลาสเพลเยอร์วิดีโอจะเรียกเมธอดนี้ด้วยเมธอด VideoPlayer.setEmsgEventHandler()

/**
 * Callback on Emsg event.
 * Instructs IMA SDK to fire back VAST events accordingly.
 * @param {!Event} event The event object.
 */
AdManager.prototype.onEmsgEvent = function(event) {
  var data = event.event.messageData;
  var pts = event.event.calculatedPresentationTime;
  if ((data instanceof Uint8Array) && data.byteLength > 0) {
    this.streamManager.processMetadata('ID3', data, pts);
  }
};

โหลดไฟล์ Manifest ของพ็อดโฆษณา

สร้างเมธอด AdManager.loadAdPodManifest() เพื่อโหลดไฟล์ Manifest ของพ็อดโฆษณาไว้ล่วงหน้าด้วยเพลเยอร์วิดีโอ สร้าง URL ไฟล์ Manifest ที่มีการตรวจสอบสิทธิ์โดยใช้ โครงสร้างใน เมธอด: ไฟล์ Manifest ของพ็อด DASH.

/**
 * Creates DAI pod url and instructs video player to load manifest.
 * @param {string} networkCode The network code.
 * @param {string} customAssetKey The custom asset key.
 * @param {number} podDuration The duration of the ad pod.
 */
AdManager.prototype.loadAdPodManifest = function (networkCode, customAssetKey, podDuration) {
  if (!this.streamData) {
    debugView.log('AdsManager: No stream data available.');
    return;
  }

  var adBreakId = this.getAdBreakId();
  var expirationTime = Math.trunc(new Date().getTime() / 1000) + 3600;

  var params = {
    ad_break_id: adBreakId,
    custom_asset_key: customAssetKey,
    exp: expirationTime,
    network_code: networkCode,
    pd: podDuration
  };

  var secretKey = getStreamSecretKeys();
  var token = this.generateAuthToken(params, secretKey.MANIFEST_SECRET);
  var encodedToken = encodeURIComponent(token);

  var manifestUrl = 'https://dai.google.com/linear/pods/v1/dash/network/' +
    networkCode + '/custom_asset/' + customAssetKey + '/stream/' +
    this.streamData.streamId + '/ad_break_id/' + adBreakId +
    '/manifest.mpd?pd=' + podDuration + '&auth-token=' + encodedToken;

  this.videoPlayer.preload(manifestUrl);
};

แอปตัวอย่าง HbbTV ใช้ค่าที่ไม่ซ้ำกันซึ่งสร้างขึ้นแบบสุ่มadBreakId ในแอปที่ใช้งานจริง ค่า adBreakId จะเป็นสตริงที่เป็นตัวอักษรและตัวเลขคละกัน เช่น ab-001 ซึ่งจะเพิ่มขึ้นทีละ 1 สำหรับช่วงพักโฆษณาแต่ละช่วง ตรวจสอบว่าค่า adBreakId เป็นค่าเดียวกันสำหรับผู้ชมช่วงพักโฆษณาทุกคน เรา ขอแนะนำให้ใช้ DAI Ad Break API เพื่อรับค่า adBreakId ในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ ให้ใส่ค่า adBreakId และค่า podDuration ในเหตุการณ์สตรีม HbbTV AD_BREAK_ANNOUNCE

จากนั้นสร้างคลาสแอปพลิเคชันหลักสำหรับแอป HbbTV ที่โต้ตอบกับการออกอากาศ HbbTV

ก่อนหน้า
ตั้งค่าคลาสโปรแกรมเล่น
ถัดไป
สร้างคลาสแอปพลิเคชัน