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]