Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lastninja294/adgent-sdk/llms.txt

Use this file to discover all available pages before exploring further.

v0.1.10• Production Ready

VAST Player SDK for Smart TVs

Lightweight, framework-agnostic video ad player designed specifically for WebOS, Tizen, Vidaa, and WhaleOS platforms. Built for performance and reliability.

Get StartedAPI Reference
VAST 4.x Compliant
< 20KB gzipped

Quick start

Get up and running in minutes

1

Install the SDK

Install Adgent SDK using your preferred package manager:
npm install adgent-sdk
2

Initialize the player

Import and configure the SDK with your VAST URL:
import { AdgentSDK } from 'adgent-sdk';

const sdk = new AdgentSDK({
  container: document.getElementById('ad-container'),
  vastUrl: 'https://example.com/vast.xml',
  targetBitrate: 2500,
  onComplete: () => console.log('Ad completed'),
  onError: (err) => console.error('Ad error:', err)
});

await sdk.init();
3

Start playback

Play the ad and handle events:
await sdk.play();
The SDK will automatically handle platform detection, media file selection, and tracking events.

Explore by topic

Everything you need to integrate video ads on Smart TV platforms

Core Concepts

Learn about VAST compliance, platform support, and the Nuclear Mute autoplay strategy

Configuration

Configure SDK settings, bitrate selection, skip behavior, and callbacks

Event Handling

Track ad lifecycle events, quartiles, user interactions, and errors

Platform Detection

Detect Smart TV platforms and handle remote control key codes

Supported platforms

Native adapters for major Smart TV platforms

WebOS

LG Smart TVs with native video player integration

Learn more

Tizen

Samsung Smart TVs with TV Player API support

Learn more

Vidaa

Hisense TVs with lightweight implementation

Learn more

WhaleOS

Naver Whale browser with optimizations

Learn more

Key features

Built specifically for Smart TV constraints

VAST 4.x Compliant

Full wrapper resolution, tracking events, and intelligent media file selection

Minimal Footprint

Target size under 20KB gzipped with single dependency (fast-xml-parser)

Fault Tolerant

Nuclear Mute autoplay strategy with soft-fail recovery mechanisms

Remote Control Ready

Built-in focus management and key code normalization for TV remotes

Ready to get started?

Build video ad experiences for Smart TV platforms with minimal code

Get Started Now