प्लेयर क्लास सेट अप करना

video_player.js में, dash.js प्लेयर को शुरू और कंट्रोल करने के लिए, वीडियो प्लेयर रैपर क्लास तय करें.

ब्रॉडबैंड प्लेयर सेट करें

वीडियो और रैपर टैग बनाकर तय करें कि आपके ऐप्लिकेशन में ब्रॉडबैंड प्लेयर कहां-कहां लगाना है:

<div id="broadband-wrapper">
    <video id="broadband-video"></video>
</div>
index.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() का इस्तेमाल करें.

1. विज्ञापन स्ट्रीम को पहले से लोड करें

विज्ञापन स्ट्रीम मेनिफ़ेस्ट को पहले से लोड करने के लिए VideoPlayer.preload() तरीका बनाएं और विज्ञापन के लिए ब्रेक से पहले विज्ञापन बफ़र बनाएं. आपको प्लेयर स्ट्रीमिंग की सेटिंग 'cacheInitSegments' को true पर सेट करना होगा. सेटिंग अपडेट करके, init सेगमेंट को कैश मेमोरी में सेव होने की सुविधा चालू की जा सकती है. इससे विज्ञापनों पर स्विच करने में होने वाली देरी से बचा जा सकता है.

/**
 * 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

2. पहले से लोड किए गए विज्ञापन बफ़र की जांच करें

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. यह तरीका इन लिसनर को हटाने के लिए क्लीनअप फ़ंक्शन सेट करने के अलावा, स्कीम आईडी यूआरआई के लिए इवेंट भी मैनेज करता है.

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() तरीका बनाकर, मैसेज वाले इवेंट के आधार पर चलने वाला कॉलबैक फ़ंक्शन सेट करें. इस गाइड के लिए, 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 SDK का इस्तेमाल करने के लिए विज्ञापन मैनेजर क्लास बनाएं. इससे, स्ट्रीम का अनुरोध किया जा सकता है, विज्ञापन पॉड मेनिफ़ेस्ट पाया जा सकता है, IMA स्ट्रीम इवेंट को सुना जा सकता है, और IMA SDK को emsg इवेंट भेजे जा सकते हैं.

पीछे जाएं
HbbTV पर शुरू करें
आगे बढ़ें
Ads मैनेजर क्लास बनाना