สร้างคลาสแอปพลิเคชัน

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

สร้างคลาสหลักสำหรับแอป HbbTV ที่โต้ตอบกับการออกอากาศ HbbTV ใน application.js คลาสนี้โต้ตอบกับ broadcastAppManager และ broadcastContainer ดูตัวอย่างคลาสที่คล้ายกันได้ที่ การจัดการออบเจ็กต์ a/v ของการออกอากาศ

แก้ไขแอป HbbTV พื้นฐานนี้เพื่อขอสตรีม IMA และตอบสนองต่อเหตุการณ์ช่วงพักโฆษณา

เริ่มต้นแอปพลิเคชัน

เริ่มต้นคลาสแอปพลิเคชันใน application.js ตั้งค่า broadcastAppManager และ broadcastContainer ตามบทแนะนำ การจัดการออบเจ็กต์ a/v ของการออกอากาศ หลังจากนั้น ให้เริ่มต้นออบเจ็กต์ VideoPlayer และ AdManager ใหม่

/** Main HbbTV Application. */
var HbbTVApp = function() {
  this.broadcastAppManager = document.getElementById('broadcast-app-manager');
  this.broadcastContainer = document.getElementById('broadcast-video');

  this.playState = -1; // -1 as null play state.

  try {
    this.applicationManager =
        this.broadcastAppManager.getOwnerApplication(document);
    this.applicationManager.show();
    this.broadcastContainer.bindToCurrentChannel();
    this.subscribedToStreamEvents = false;
    this.broadcastContainer.addEventListener(
        'PlayStateChange', this.onPlayStateChangeEvent.bind(this));

    debugView.log('HbbTVApp: App loaded');
    this.videoPlayer = new VideoPlayer();
    this.videoPlayer.setOnAdPodEnded(this.resumeBroadcast.bind(this));
  } catch (e) {
    debugView.log('HbbTVApp: No HbbTV device detected.');
    return;
  }

  this.adManager = new AdManager(this.videoPlayer);
};
application.js

ส่งคำขอสตรีม IMA

ในเมธอด HbbTVApp.onPlayStateChangeEvent() ให้ส่งคำขอสตรีมเพื่อตอบสนองต่อการเปลี่ยนแอปเป็น PRESENTING_PLAYSTATE แนวทางนี้จะเตรียมแอปให้โหลดไฟล์ Manifest ของพ็อดโฆษณาเพื่อตอบสนองต่อเหตุการณ์ AD_BREAK_EVENT_ANNOUNCE

if (!this.subscribedToStreamEvents &&
    this.broadcastContainer.playState == PRESENTING_PLAYSTATE) {
  this.subscribedToStreamEvents = true;
  this.broadcastContainer.addStreamEventListener(
      STREAM_EVENT_URL, 'eventItem', function(event) {
        this.onStreamEvent(event);
      }.bind(this));
  debugView.log('HbbTVApp: Subscribing to stream events.');
  this.adManager.requestStream(NETWORK_CODE, CUSTOM_ASSET_KEY);
}
application.js

หากอุปกรณ์ไม่ปล่อยเหตุการณ์ PlayStateChange ของคอนเทนเนอร์การออกอากาศอย่างถูกต้อง ให้ใช้ฟังก์ชัน setInterval() เพื่อตรวจสอบการเปลี่ยนแปลงสถานะการเล่น

setInterval(function() {
      if (!subscribedToStreamEvents &&
            this.broadcastContainer.playState == PRESENTING_PLAYSTATE) {
        subscribedToStreamEvents = true;
        this.broadcastContainer.addStreamEventListener(
            STREAM_EVENT_URL, 'eventItem', function(event) {
              this.onStreamEvent(event);
            }.bind(this));
        debugView.log('Subscribing to stream events');
        this.adManager.requestStream(NETWORK_CODE, CUSTOM_ASSET_KEY);
      }
      …

รอเหตุการณ์สตรีม HbbTV

สร้างเมธอด HbbTVApp.onStreamEvent() เพื่อรอเหตุการณ์ช่วงพักโฆษณา adBreakAnnounce, adBreakStart และ adBreakEnd

/**
 * Callback for HbbTV stream event.
 * @param {!Event} event Stream event payload.
 */
HbbTVApp.prototype.onStreamEvent = function(event) {
  var eventData = JSON.parse(event.text);
  var eventType = eventData.type;
  if (eventType == AD_BREAK_EVENT_ANNOUNCE) {
    this.onAdBreakAnnounce(eventData);
  } else if (eventType == AD_BREAK_EVENT_START) {
    this.onAdBreakStart(eventData);
  } else if (eventType == AD_BREAK_EVENT_END) {
    this.onAdBreakEnd(eventData);
  }
};
application.js

จัดการเหตุการณ์สตรีม HbbTV

หากต้องการจัดการเหตุการณ์สตรีม HbbTV ให้ทำตามขั้นตอนต่อไปนี้

1. หากต้องการโหลดไฟล์ Manifest ของพ็อดโฆษณาเพื่อตอบสนองต่อเหตุการณ์ adBreakAnnounce ให้สร้างเมธอด HbbTVApp.onAdBreakAnnounce() ดังนี้

   /**
    * Callback function on ad break announce stream event.
    * @param {!Event} event HbbTV stream event payload.
    */
   HbbTVApp.prototype.onAdBreakAnnounce = function(event) {
     var eventType = event.type;
     var eventDuration = event.duration;
     var eventOffset = event.offset;
     debugView.log(
         'HbbTV event: ' + eventType + ' duration: ' + eventDuration +
         's offset: ' + eventOffset + 's');
     this.adManager.loadAdPodManifest(NETWORK_CODE, CUSTOM_ASSET_KEY, eventDuration);
   };
   application.js

2. หากต้องการเปลี่ยนไปเล่นสตรีมโฆษณาในระหว่างช่วงพักโฆษณา ให้สร้างเมธอด HbbTVApp.onAdBreakStart() ดังนี้

   /**
    * Callback function on ad break start stream event.
    * @param {!Event} event HbbTV stream event payload.
    */
   HbbTVApp.prototype.onAdBreakStart = function(event) {
     debugView.log('HbbTV event: ' + event.type);
     if (!this.videoPlayer.isPreloaded()) {
       debugView.log('HbbTVApp: Switch aborted. ' +
                     'The ad preloading buffer is insufficient.');
       return;
     }
     this.stopBroadcast();
     this.videoPlayer.play();
   };
   application.js

3. หากต้องการกลับไปที่การออกอากาศเนื้อหา ให้สร้างเมธอด HbbTVApp.onAdBreakEnd() ดังนี้

   /**
    * Callback function on ad break end stream event.
    * @param {!Event} event HbbTV stream event payload.
    */
   HbbTVApp.prototype.onAdBreakEnd = function(event) {
     debugView.log('HbbTV event: ' + event.type);
     this.videoPlayer.stop();
     this.resumeBroadcast();
   };
   application.js

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