Utwórz zajęcia w Menedżerze reklam

Uwaga: zanim przejdziesz do dalszej części tego przewodnika, musisz wykonać czynności opisane w sekcji Konfigurowanie klasy graczy.

W pliku ads_manager.js zdefiniuj klasę opakowującą dla pakietu IMA SDK StreamManager, która wysyła żądania strumienia, pobiera plik manifestu podgrupy reklam, nasłuchuje zdarzeń strumienia IMA i przekazuje zdarzenia emsg do pakietu IMA SDK.

W ads_manager.js przykładowa aplikacja IMA HbbTV konfiguruje te metody:

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

Inicjalizacja menedżera reklam

Inicjalizacja klasy menedżera reklam i ustawienie odbiorników zdarzeń strumienia IMA. W tym wywołaniu ustaw moduł obsługi zdarzenia emsg za pomocą metody VideoPlayer.setEmsgEventHandler().

Ważna informacja: pakiet IMA SDK nie obsługuje interfejsu reklamowego w HbbTV. Nie przekazuj parametru adUiElement w konstruktorze StreamManager. Przekazywanie wartościadUiElement może spowodować wyświetlanie przez Ad Managera reklam niezgodnych z reklamami w innych jednostkach reklamowych.

/**
 * 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);
};
ads_manager.js

Przesyłanie żądania strumienia bloku reklamowego

Utwórz metodę AdManager.requestStream(), aby utworzyć obiekt PodStreamRequest za pomocą kodu sieci Google Ad Manager i klucza zasobu niestandardowego strumienia. Przetestuj swoją aplikację HbbTV, korzystając z przykładowego strumienia pod służącego do wyświetlania reklam DASH firmy IMA z tymi parametrami strumienia:

• Kod sieci: '21775744923'
• Klucz zasobu niestandardowego: '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();
  streamRequest.networkCode = networkCode;
  streamRequest.customAssetKey = customAssetKey;
  streamRequest.format = 'dash';
  debugView.log('AdsManager: make PodStreamRequest');
  this.streamManager.requestStream(streamRequest);
};
ads_manager.js

Nasłuchiwanie zdarzeń strumienia reklam

Utwórz metodę AdManager.onStreamEvent(), aby obsłużyć odpowiedź aplikacji na zdarzenia strumienia IMA: STREAM_INITIALIZED, AD_BREAK_STARTED i 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;
  }
};
ads_manager.js

Obsługa metadanych strumienia reklam

Aby przekazać informacje o zdarzeniu emsg do IMA, utwórz metodę AdManager.onEmsgEvent() za pomocą metody StreamManager.processMetadata(). Klasa odtwarzacza wideo wywołuje tę metodę za pomocą metody 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);
  }
};
ads_manager.js

Ładowanie pliku manifestu podreklamy

Utwórz metodę AdManager.loadAdPodManifest(), aby wstępnie załadować manifest bloku reklamowego za pomocą odtwarzacza wideo. Utwórz adres URL pliku manifestu, używając struktury opisanej w sekcji Metoda: DASH pod manifest.

/**
 * 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('IMA SDK: No DAI pod session registered.');
    return;
  }

  var MANIFEST_BASE_URL = 'https://dai.google.com/linear/pods/v1/dash/network/';
  // Method: DASH pod manifest reference docs:
  // https://developers.google.com/ad-manager/dynamic-ad-insertion/api/pod-serving/reference/live#method_dash_pod_manifest
  var manifestUrl = MANIFEST_BASE_URL + networkCode + '/custom_asset/' +
    customAssetKey + '/stream/' + this.streamData.streamId + '/pod/' +
    this.getPodId() + '/manifest.mpd?pd=' + podDuration;
  this.videoPlayer.preload(manifestUrl);
};
ads_manager.js

Przykładowa aplikacja HbbTV korzysta z losowo wygenerowanego unikalnego podId. W wersjach produkcyjnych aplikacji wartość podId jest liczbą całkowitą, która zaczyna się od 1 i zwiększa się o 1 za każdym przerwą na reklamę. Upewnij się, że wartość podId jest taka sama dla wszystkich widzów przerwy na reklamę. Aby uzyskać podId, zalecamy użycie interfejsu Early Ad Break Notification (EABN) API. W środowisku produkcyjnym dodaj parametry podId i podDuration do zdarzenia strumienia HbbTV AD_BREAK_ANNOUNCE.

Następnie utwórz główną klasę aplikacji dla aplikacji HbbTV, która będzie wchodzić w interakcję z transmisją HbbTV.