প্লেয়ার ক্লাস সেট-আপ করা

মনে রাখবেন: এই নির্দেশিকা অনুযায়ী কাজ করার আগে, আপনাকে HbbTV-তে IMA SDK ব্যবহার শুরু করুন লিঙ্কে দেওয়া ধাপগুলি সম্পূর্ণ করতে হবে।

video_player.js-এ, dash.js প্লেয়ার শুরু ও নিয়ন্ত্রণ করতে একটি ভিডিও প্লেয়ার র‍্যাপার ক্লাস নির্ধারণ করুন।

ব্রডব্যান্ড প্লেয়ার সেট-আপ করুন

ভিডিও এবং র‍্যাপার ট্যাগ তৈরি করে আপনার অ্যাপের কোথায় ব্রডব্যান্ড প্লেয়ার প্লেস করবেন তা নির্ধারণ করুন:

<div id="broadband-wrapper">
    <video id="broadband-video"></video>
</div>
index.html

ভিডিও প্লেয়ার তৈরি করুন

HTML এলিমেন্ট, dash.js প্লেয়ার এবং অন্যান্য ক্লাস মেথড ব্যবহার করতে পারে এমন কলব্যাকের জন্য ভেরিয়েবল সহ ভিডিও প্লেয়ার ক্লাস ইনিশিয়ালাইজ করুন।

/**
 * Video player wrapper class to control ad creative playback with dash.js in
 * broadband.
 */
var VideoPlayer = function() {
  this.videoElement = document.querySelector('video');
  this.broadbandWrapper = document.getElementById('broadband-wrapper');
  this.player = dashjs.MediaPlayer().create();
  this.onAdPodEndedCallback = null;

  // Function passed in VideoPlayer.prototype.setEmsgEventHandler.
  this.onCustomEventHandler = null;
  //  Scope (this) passed in VideoPlayer.prototype.setEmsgEventHandler.
  this.customEventHandlerScope = null;

  // Function to remove all of player event listeners.
  this.cleanUpPlayerListener = null;
  debugView.log('Player: Creating dash.js player');
};
video_player.js

প্লেব্যাক কন্ট্রোল ফাংশন সংজ্ঞায়িত করুন

বিজ্ঞাপন প্লেয়ার দেখাতে এবং ভিডিও ভিউ অ্যাটাচ করতে, VideoPlayer.play() মেথড তৈরি করুন। এরপর, অ্যাড পড শেষ হওয়ার পরে ক্লিন-আপ ম্যানেজ করার জন্য VideoPlayer.stop() পদ্ধতি তৈরি করুন।

/** Starts playback of ad stream. */
VideoPlayer.prototype.play = function() {
  debugView.log('Player: Start playback');
  this.show();
  this.player.attachView(this.videoElement);
};

/** Stops ad stream playback and deconstructs player. */
VideoPlayer.prototype.stop = function() {
  debugView.log('Player: Request to stop player');
  if (this.cleanUpPlayerListener) {
    this.cleanUpPlayerListener();
  }
  this.player.reset();
  this.player.attachView(null);
  this.player.attachSource(null);
  this.player = null;
  this.hide();
};
video_player.js

বিজ্ঞাপন স্ট্রিম ম্যানিফেস্ট প্রিলোড করুন

কন্টেন্ট স্ট্রিম চলাকালীন এবং বিজ্ঞাপন বিরতি শুরু হওয়ার আগে বিজ্ঞাপনগুলি পর্যাপ্তভাবে লোড হয়েছে কিনা তা যাচাই করতে, VideoPlayer.preload() এবং VideoPlayer.isPreloaded() ব্যবহার করুন।

১. বিজ্ঞাপন স্ট্রিম প্রিলোড করুন

বিজ্ঞাপন বিরতির আগে বিজ্ঞাপন বাফার তৈরি করতে এবং বিজ্ঞাপন স্ট্রিম ম্যানিফেস্ট প্রিলোড করতে VideoPlayer.preload() পদ্ধতি তৈরি করুন। আপনাকে অবশ্যই প্লেয়ার স্ট্রিমিং সেটিংস 'cacheInitSegments' থেকে true-এ আপডেট করতে হবে। সেটিংস আপডেট করার মাধ্যমে, আপনি ইনিট সেগমেন্ট ক্যাশে করার সুবিধা চালু করেন, যা বিজ্ঞাপনে পরিবর্তন করার সময় হওয়া বিলম্ব এড়ায়।

/**
 * Starts ad stream prefetching into Media Source Extensions (MSE) buffer.
 * @param {string} url manifest url for ad stream playback.
 */
VideoPlayer.prototype.preload = function(url) {
  if (!this.player) {
    this.player = dashjs.MediaPlayer().create();
  }
  debugView.log('Player: init with ' + url);
  this.player.initialize(/* HTMLVideoElement */ null, url, /* autoplay */ true);

  this.player.updateSettings({
    'debug': {
      'logLevel': dashjs.Debug.LOG_LEVEL_WARNING,
      'dispatchEvent': true,  // flip to false to hide all debug events.
    },
    'streaming': {
      'cacheInitSegments': true,
    }
  });
  this.player.preload();
  this.attachPlayerListener();
  debugView.log('Player: Pre-loading into MSE buffer');
};
video_player.js

২. প্রিলোড করা বিজ্ঞাপন বাফার চেক করুন

অ্যাপে সেট করা বাফার থ্রেশহোল্ডের তুলনায় পর্যাপ্ত বিজ্ঞাপন বাফার প্রিলোড করা হয়েছে কিনা তা চেক করতে VideoPlayer.isPreloaded() পদ্ধতি তৈরি করুন:

// Ads will only play with 10 or more seconds of ad loaded.
var MIN_BUFFER_THRESHOLD = 10;
video_player.js

/**
 * Checks if the ad is preloaded and ready to play.
 * @return {boolean} whether the ad buffer level is sufficient.
 */
VideoPlayer.prototype.isPreloaded = function() {
  var currentBufferLevel = this.player.getDashMetrics()
      .getCurrentBufferLevel('video', true);
  return currentBufferLevel >= MIN_BUFFER_THRESHOLD;
};
video_player.js

প্লেয়ার লিসনার অ্যাটাচ করুন

dash.js প্লেয়ার ইভেন্টের জন্য ইভেন্ট লিসেনার যোগ করতে, VideoPlayer.attachPlayerListener() পদ্ধতি তৈরি করুন: PLAYBACK_PLAYING, PLAYBACK_ENDED, LOG এবং ERROR। এই পদ্ধতিটি স্কিম আইডি URI-এর জন্য ইভেন্টগুলিও পরিচালনা করে, সাথে এই লিসেনারদের সরানোর জন্য ক্লিন-আপ ফাংশন সেট করে।

var SCHEME_ID_URI = 'https://developer.apple.com/streaming/emsg-id3';
video_player.js

/** Attaches event listener for various dash.js events.*/
VideoPlayer.prototype.attachPlayerListener = function() {
  var playingHandler = function() {
    this.onAdPodPlaying();
  }.bind(this);
  this.player.on(dashjs.MediaPlayer.events['PLAYBACK_PLAYING'], playingHandler);
  var endedHandler = function() {
    this.onAdPodEnded();
  }.bind(this);
  this.player.on(dashjs.MediaPlayer.events['PLAYBACK_ENDED'], endedHandler);
  var logHandler = function(e) {
    this.onLog(e);
  }.bind(this);
  this.player.on(dashjs.MediaPlayer.events['LOG'], logHandler);
  var errorHandler = function(e) {
    this.onAdPodError(e);
  }.bind(this);
  this.player.on(dashjs.MediaPlayer.events['ERROR'], errorHandler);

  var customEventHandler = null;
  if (this.onCustomEventHandler) {
    customEventHandler =
        this.onCustomEventHandler.bind(this.customEventHandlerScope);
    this.player.on(SCHEME_ID_URI, customEventHandler);
  }

  this.cleanUpPlayerListener = function() {
    this.player.off(
        dashjs.MediaPlayer.events['PLAYBACK_PLAYING'], playingHandler);
    this.player.off(dashjs.MediaPlayer.events['PLAYBACK_ENDED'], endedHandler);
    this.player.off(dashjs.MediaPlayer.events['LOG'], logHandler);
    this.player.off(dashjs.MediaPlayer.events['ERROR'], errorHandler);
    if (customEventHandler) {
      this.player.off(SCHEME_ID_URI, customEventHandler);
    }
  };
};
video_player.js

প্লেয়ার ইভেন্ট কলব্যাক সেট করুন

প্লেয়ার ইভেন্টের উপর ভিত্তি করে বিজ্ঞাপন পড প্লেব্যাক ম্যানেজ করতে, VideoPlayer.onAdPodPlaying(), VideoPlayer.onAdPodEnded() এবং VideoPlayer.onAdPodError() পদ্ধতি তৈরি করুন:

/**
 * Called when ad stream playback buffered and is playing.
 */
VideoPlayer.prototype.onAdPodPlaying = function() {
  debugView.log('Player: Ad Playback started');
};

/**
 * Called when ad stream playback has been completed.
 * Will call the restart of broadcast stream.
 */
VideoPlayer.prototype.onAdPodEnded = function() {
  debugView.log('Player: Ad Playback ended');
  this.stop();
  if (this.onAdPodEndedCallback) {
    this.onAdPodEndedCallback();
  }
};

/**
 * @param {!Event} event The error event to handle.
 */
VideoPlayer.prototype.onAdPodError = function(event) {
  debugView.log('Player: Ad Playback error from dash.js player.');
  this.stop();
  if (this.onAdPodEndedCallback) {
    this.onAdPodEndedCallback();
  }
};
video_player.js

onAdPodEnded ইভেন্টের জন্য সেটার তৈরি করুন

VideoPlayer.setOnAdPodEnded() পদ্ধতি তৈরি করে, বিজ্ঞাপন পড শেষ হলে রান করে এমন একটি কলব্যাক ফাংশন সেট করুন। বিজ্ঞাপন বিরতির পরে কন্টেন্ট ব্রডকাস্ট আবার শুরু করতে অ্যাপ ক্লাস এই পদ্ধতি ব্যবহার করে।

/**
 * Sets a callback function for when an ad pod has ended.
 * @param {!Function} callback Callback function.
 */
VideoPlayer.prototype.setOnAdPodEnded = function(callback) {
  this.onAdPodEndedCallback = callback;
};
video_player.js

স্ট্রিম মেটাডেটা ইভেন্ট ম্যানেজ করা

VideoPlayer.setEmsgEventHandler() পদ্ধতি তৈরি করে emsg ইভেন্টের উপর ভিত্তি করে রান করে এমন একটি কলব্যাক ফাংশন সেট করুন। এই গাইডের জন্য, scope প্যারামিটার অন্তর্ভুক্ত করুন, কারণ আপনি video_player.js-এর বাইরে setEmsgEventHandler()-কে ইভোক করেন।

/**
 * Sets emsg event handler.
 * @param {!Function} customEventHandler Event handler.
 * @param {!Object} scope JS scope in which event handler function is called.
 */
VideoPlayer.prototype.setEmsgEventHandler = function(
    customEventHandler, scope) {
  this.onCustomEventHandler = customEventHandler;
  this.customEventHandlerScope = scope;
};
video_player.js

বিজ্ঞাপন বিরতির জন্য ভিডিও প্লেয়ার দেখুন বা লুকান

বিজ্ঞাপন বিরতির সময় ভিডিও প্লেয়ার দেখাতে এবং বিজ্ঞাপন বিরতি শেষ হওয়ার পরে প্লেয়ার লুকাতে, VideoPlayer.show() এবং VideoPlayer.hide() মেথড তৈরি করুন:

/** Shows the video player. */
VideoPlayer.prototype.show = function() {
  debugView.log('Player: show');
  this.broadbandWrapper.style.display = 'block';
};

/** Hides the video player. */
VideoPlayer.prototype.hide = function() {
  debugView.log('Player: hide');
  this.broadbandWrapper.style.display = 'none';
};
video_player.js

এরপর, স্ট্রিম অনুরোধ করতে, বিজ্ঞাপন পড ম্যানিফেস্ট পেতে, IMA স্ট্রিম ইভেন্ট শুনতে এবং IMA SDK-তে emsg ইভেন্ট পাস করতে IMA SDK ব্যবহার করার জন্য একটি বিজ্ঞাপন ম্যানেজার ক্লাস তৈরি করুন।