> ## 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.

# Swift 视频 SDK

> 面向短剧及其他视频优先 iOS 应用的叠加、暂停和线性视频广告。

> **[Swift 视频 SDK](https://github.com/kontextso/sdk-swift-video)**
>
> 一个把广告放进你播放器的 Swift SDK：内容上方的条幅、暂停时的卡片，或两集之间的全屏广告。

视频 SDK 与面向聊天应用的 [Swift SDK](https://docs.kontext.so/zh/sdk/swift.md) 是两个独立的 SDK。它们连接同一个广告服务器，但视频 SDK 的模型是视频应用熟悉的移动广告 SDK 模式：请求一个广告，看它的价格，加载，在你选的时刻展示，结束时收到一个回调。

## 三种格式

> **叠加广告**
>
> 内容播放时横跨播放器的条幅。时长到后自行结束，或由观众关闭。

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

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

## 要求

* iOS 14.0+
* Swift 5.9+
* Xcode 15+

> [!NOTE]
>
> 你需要一个[发布方账号](https://docs.kontext.so/zh/publishers.md#启动方式很简单)来获取 `publisherToken`。

> **[安装](https://docs.kontext.so/zh/video/sdk/swift/installation.md)**
>
> 添加包、初始化 SDK、配置 ATT 和 SKAdNetwork。

> **[展示第一个广告](https://docs.kontext.so/zh/video/sdk/swift/first-ad.md)**
>
> 创建视频的广告对象、获取广告、加载、展示：叠加、暂停和线性。

> **[API 参考](https://docs.kontext.so/zh/video/sdk/swift/api.md)**
>
> 每个类型、方法、回调和错误。

> **[指南](https://docs.kontext.so/zh/video/sdk/swift/guides.md)**
>
> 同时加载多个广告、你自己的竞价、无填充、播放位置等等。

> **[示例应用](https://docs.kontext.so/zh/video/sdk/swift/example.md)**
>
> 一个带全部三种格式的 SwiftUI 播放器，可用你的发布方 token 运行。


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