Skip to main content

Kotlin Video SDK

An Android SDK that puts ads into your video player: a strip over the content, a card while it is paused, or a full-screen spot between episodes.
The Video SDK is a separate SDK from the Kotlin SDK for chat apps. It speaks the same ad server, but its model is the one video apps know from mobile ad SDKs: ask for an ad, look at its price, load it, show it at the moment you pick, and get one callback when it ends.

​
The three formats

Overlay

A strip across the player while the content plays. Ends by itself after its duration, or when the viewer closes it.

Pause

A card, or the full player, while the content is paused. Stays until the viewer resumes or you dismiss it.

Linear

A full-screen video at a moment you choose: between episodes, before a premium one. Skippable when the advertiser allows.

​
Requirements

  • Android 7.0 (API 24)+
  • compileSdk 35+
  • JDK 17 (Android Gradle Plugin 8)
  • Kotlin or Java; Media3 for the optional player adapter
You’ll need a publisher account to obtain your publisherToken.

Installation

Add the dependency, initialize the SDK, and what it adds to your manifest.

Showing your first ad

Create the video’s ads, get an ad, load it, show it: overlay, pause and linear.

API reference

Every type, method, callback and error.

Guides

Loading several ads at once, your own auction, no-fill, the player, Compose, Java, and more.

Example app

An ExoPlayer app with all three formats, runnable against your publisher token.