> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kontext.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Kotlin Video SDK

> Overlay, pause and linear video ads for short-drama and other video-first Android apps.

> [card] [Kotlin Video SDK](https://github.com/kontextso/sdk-kotlin-video)
>
> 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](https://docs.kontext.so/sdk/kotlin.md) 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

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

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

> [card] 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](https://developer.android.com/media/media3) for the optional player adapter

> [!NOTE]
>
> You'll need a [publisher account](https://docs.kontext.so/publishers.md#getting-started-is-easy) to obtain your `publisherToken`.

> [card] [Installation](https://docs.kontext.so/video/sdk/kotlin/installation.md)
>
> Add the dependency, initialize the SDK, and what it adds to your manifest.

> [card] [Showing your first ad](https://docs.kontext.so/video/sdk/kotlin/first-ad.md)
>
> Create the video's ads, get an ad, load it, show it: overlay, pause and linear.

> [card] [API reference](https://docs.kontext.so/video/sdk/kotlin/api.md)
>
> Every type, method, callback and error.

> [card] [Guides](https://docs.kontext.so/video/sdk/kotlin/guides.md)
>
> Loading several ads at once, your own auction, no-fill, the player, Compose, Java, and more.

> [card] [Example app](https://docs.kontext.so/video/sdk/kotlin/example.md)
>
> An ExoPlayer app with all three formats, runnable against your publisher token.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.