GiriAakula

SGAI (Server-Guided Ad Insertion) Technical Documentation

This document provides a technical overview of the Server-Guided Ad Insertion (SGAI) feature as implemented in the proof-of-concept index.html file. It is intended for developers and engineers who need to understand, maintain, or extend this functionality.

1. Introduction

The SGAI feature enables the insertion of advertisements into a Video on Demand (VOD) stream in a manner guided by the server. This implementation leverages AWS MediaTailor to dynamically insert ads into an HLS stream, with the client-side player handling the ad playback, tracking, and content resumption.

The primary goal is to provide a seamless ad experience for the user, where ads are played at specific points in the content timeline as dictated by the HLS manifest.

M3U8

https://stream.mux.com/XAUyVQNQUpHCFH2qXYgi3JOcmGs4xovhczrhHQsgqJ4.m3u8

Dash

Videojs Player Errors

To handle errors in Videojs player, you can use the following code:

const errorCodes = ["MEDIA_ERR_CUSTOM", "MEDIA_ERR_ABORTED", "MEDIA_ERR_NETWORK", "MEDIA_ERR_DECODE", "MEDIA_ERR_SRC_NOT_SUPPORTED", "MEDIA_ERR_ENCRYPTED"];

playerInstance.on("error", function() {
  sendEvent("playerError", errorCodes[playerInstance.error().code]);
});

if(tap === true)
  if(autoplay === true)
      if(mute === true)
        Video will play with taptounmute, with autoplay and with mute
        
        
if(tap === true)
  if(autoplay === true)
      if(mute === false)

Vidgyor Video Player - Error Types

Vidgyor player mainly emits six types of errors.

MEDIA_ERR_CUSTOM
MEDIA_ERR_ABORTED
MEDIA_ERR_NETWORK
MEDIA_ERR_DECODE
MEDIA_ERR_SRC_NOT_SUPPORTED
MEDIA_ERR_ENCRYPTED

Vidgyor Midroll Plugin Docs

To integrate the midroll plugin to your existing videojs player follow the below steps.

Add CSS

<link rel="stylesheet" href="https://vgrplayer.s3.ap-south-1.amazonaws.com/midroll-test-player/vidgyor-vjs_v3.css">

Add Javascript

<script src="https://vgrplayer.s3.ap-south-1.amazonaws.com/midroll-player/ads.min.js"></script>

	Paused after 2 secs of ad start

	Resumed after 1 min

	Ad break fucked up

	----------------------------------


	If the ad break comes in first 10 secs

	In the server go to the wordpress path.. in most systems it is
	/var/www/wordpress/wp-includes/embed.php


	In the above file add this

	wp_embed_register_handler( 'vidgyor', '#https://static\.vidgyor\.com/player/vod/html/(.+?)\.html\?videoId=(.+?)&cmsAccountId=(.+?)&masterProfileId=(.+?)($\|&)#i', 'wp_embed_handler_vidgyor' );

	function wp_embed_handler_vidgyor( $matches, $attr, $url, $rawattr ) {

	const crypto = require("crypto")

	// The `generateKeyPairSync` method accepts two arguments:
	// 1. The type ok keys we want, which in this case is "rsa"
	// 2. An object with the properties of the key
	const { publicKey, privateKey } = crypto.generateKeyPairSync("rsa", {
	// The standard secure default length for RSA keys is 2048 bits
	modulusLength: 2048,
	})

	// This is for getting data from aws s3 bucket UI.

	document.querySelector("something").children.forEach(child => console.log(child.children[1].textContent))