Videojs MediaTailor SSAI Integration

Video.js plugin to easily integrate AWS MediaTailor's Server Side Ad Integration (SSAI).

For more information on mediatailor ssai integration refer to the aws official documentation : https://docs.aws.amazon.com/mediatailor/latest/ug/server-guided.html

🗒️ What does this plugin do?

• Based on the tracking url response , it places yellow markers on the seekbar indicating start of the ad-pod.

• Shows the ad-counter with remaining timer for each individual ad on the top left of the video.

• Advetisement Beaconing of selective events based on tracking url response.
  Supported Beacon Events : ['breakStart', 'breakEnd', 'firstQuartile', 'thirdQuartile', 'midpoint', 'impression', 'complete']

• Seeks back to the recent ad-pod if user attempts to skip.

• Disables seekbar and prevent user to skip when current advertisement is playing.

⚙️ Installation and Usage.

npm i videojs-mediatailor-ssai

💡 Note: Ensure that the manifest URL of the stitched ad asset is called, and the asset is loaded into the player before calling the vjs_mediatailor_ssai fn as shown below :

player.one('loadeddata',() => {
   player.vjs_mediatailor_ssai({
        trackingUrl: 'TRACKING URL from mediatailor'
    })
})

👉🏻 Options

Option	Type	Required	Description
trackingUrl	String	✅ Yes	AWS Media Tailor Tracking URL
adEventCallback	Function	❌ No	Triggers when an advertisement beacon is fired
skipAds	Boolean	❌ No	Allows to skip advetisement
disableBeacon	Boolean	❌ No	Disables advertisement beacons

💬 Have a feature request / suggestion?

Feel free to raise the issue or reach out to me on [email protected]