跳转到主要内容

Kotlin 视频 SDK

一个把广告放进你播放器的 Android SDK:内容上方的条幅、暂停时的卡片,或两集之间的全屏广告。
视频 SDK 与面向聊天应用的 Kotlin SDK 是两个独立的 SDK。它们连接同一个广告服务器,但视频 SDK 的模型是视频应用熟悉的移动广告 SDK 模式:请求一个广告,看它的价格,加载,在你选的时刻展示,结束时收到一个回调。

三种格式

叠加广告

内容播放时横跨播放器的条幅。时长到后自行结束,或由观众关闭。

暂停广告

内容暂停时的卡片或整个播放器。停留到观众继续播放或你关闭它。

线性广告

你选择的时刻的全屏视频:两集之间、付费剧集之前。广告主允许时可跳过。

要求

  • Android 8.0(API 26)+
  • compileSdk 34+(使用 Media3 1.6 或更高版本时为 35)
  • JDK 17(Android Gradle Plugin 8)
  • Kotlin 2.0 或更高版本;可选的播放器适配器需要 Media3
你需要一个发布方账号来获取 publisherToken。

安装

添加依赖、初始化 SDK,以及它在你的 manifest 中添加了什么。

展示第一个广告

创建视频的广告对象、获取广告、加载、展示:叠加、暂停和线性。

API 参考

每个类型、方法、回调和错误。

你的播放器

Media3、TTSDK、腾讯云播放器,或通过 ContentPlayer 接入任何播放器。

Jetpack Compose

来自 so.kontext:video-compose 的 rememberVideoAds 和 VideoAdHost。

指南

同时加载多个广告、你自己的竞价、无填充、避开控件、信息流、下一集、观众、页面的生命周期。

示例应用

一个带全部三种格式的 ExoPlayer 应用,可用你的发布方 token 运行。