Skip to main content

​
What is Adgent SDK?

Adgent SDK is a high-performance, lightweight VAST (Video Ad Serving Template) player SDK designed specifically for Smart TV platforms. It provides a robust foundation for displaying video advertisements with full VAST 4.x compliance while maintaining a minimal footprint of under 20KB gzipped.
Adgent SDK is framework-agnostic and works with any JavaScript/TypeScript project, making it perfect for Smart TV apps built with React, Vue, vanilla JavaScript, or any other framework.

​
Key Features

VAST 4.x Compliance

Full wrapper resolution, tracking events, and intelligent media file selection based on bitrate and device capabilities

Smart TV Optimized

Native adapters for WebOS, Tizen, Vidaa, WhaleOS with platform-specific optimizations and remote control support

Lightweight

Under 20KB gzipped with only one dependency (fast-xml-parser), ensuring fast load times on TV hardware

Fault Tolerant

Nuclear Mute autoplay strategy with soft-fail recovery mechanisms to handle TV platform quirks

​
Why Use Adgent SDK?

​
Smart TV Optimization

Unlike generic web video players, Adgent SDK is purpose-built for Smart TV constraints:
  • Limited Processing Power: Optimized for TV hardware from 2016+ with minimal CPU/memory overhead
  • Remote Control Navigation: Built-in focus management and key code normalization across platforms
  • Network Constraints: Intelligent bitrate selection (default 2500kbps for 1080p) to prevent buffering on TV WiFi
  • Autoplay Handling: Nuclear Mute strategy (muted + playsinline + autoplay) maximizes playback success rates

​
VAST 4.x Compliance

Full support for modern VAST specifications:
  • Wrapper chain resolution up to 5 levels deep
  • Tracking pixels for impressions, quartiles, completion, and custom events
  • Smart media file selection based on codec compatibility (H.264 preferred, filters out VPAID)
  • Macro replacement for dynamic tracking URLs

​
Zero Framework Dependencies

Works seamlessly with any JavaScript/TypeScript project: 
// React
import { AdgentSDK } from 'adgent-sdk';

// Vue
import { AdgentSDK } from 'adgent-sdk';

// Vanilla JS
const { AdgentSDK } = require('adgent-sdk');
No VPAID Support: Adgent SDK explicitly excludes VPAID executables for performance, stability, and security reasons on Smart TV platforms. VPAID can cause memory leaks and crashes on resource-constrained TV hardware.

​
Platform Support

PlatformVersionStatus
WebOS3.0+✅ Fully Supported
Tizen4.0+✅ Fully Supported
Vidaa2.0+✅ Fully Supported
WhaleOS1.0+✅ Fully Supported
Generic WebModern browsers✅ Fully Supported

​
Next Steps

Installation

Install Adgent SDK via npm, yarn, or pnpm

Quickstart

Get your first ad playing in 5 minutes

Build docs developers (and LLMs) love

Get started for freeTalk to us