# avkit

Помогает настраивать воспроизведение медиа в iOS: от полноэкранных плееров AVPlayerViewController до оверлеев в SwiftUI VideoPlayer и фонового режима PiP.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3200 установок · ★ 1237
- Автор: dpearson2699
- Лицензия: LicenseRef-Unknown · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dpearson2699/swift-ios-skills/tree/HEAD/skills/avkit/SKILL.md
- Обновлён: 2026-07-31
- HTML: https://affpapa.org/nevibecode/skills/avkit

## Что делает

Скилл содержит шаблоны интеграции медиаплееров на Swift для iOS. Он направляет агента при настройке `AVPlayerViewController` в UIKit и `VideoPlayer` в SwiftUI. Плеер нельзя сабклассить: инструкции требуют использовать стандартный контроллер или оборачивать его в дочерний `UIViewController`.

Отдельное внимание уделено фоновым режимам, AirPlay и Picture-in-Picture. Для запуска плавающего окна обязательно включить фоновый режим аудио в `UIBackgroundModes`, настроить категорию `.playback` в `AVAudioSession` и отложить вызов `setActive(true)` до старта воспроизведения. Если дорожка содержит только аудио или кодек не поддерживается, режим PiP не включится даже при верных системных настройках.

Чтобы экран не моргал чёрным цветом при загрузке, код отслеживает свойство `isReadyForDisplay`. Для расширенного контроля над событиями плеера в SwiftUI скилл подсказывает обёртку через `UIViewControllerRepresentable`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill avkit -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/avkit/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/avkit/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill avkit -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/avkit/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill avkit -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/avkit/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dpearson2699/swift-ios-skills avkit
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/avkit/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill avkit -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/avkit
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/avkit/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill avkit -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dpearson2699/swift-ios-skills/tree/HEAD/skills/avkit/SKILL.md

## Когда брать
- встроить системный плеер AVPlayerViewController в UIKit
- настроить фоновое воспроизведение и режим Picture-in-Picture
- добавить интерактивный оверлей поверх SwiftUI VideoPlayer
- предотвратить чёрную вспышку перед началом показа видео

## Примеры запросов агенту
- Покажи, как встроить AVPlayerViewController как дочерний контроллер в контейнер
- Настрой AVAudioSession и фоновый режим для работы Picture-in-Picture в iOS
- Сделай плеер на SwiftUI VideoPlayer с логотипом поверх видео

## Похожие
- [axiom-media](https://affpapa.org/nevibecode/skills/axiom-media.md) — скилл · 1300 установок
- [iphone-duo-camera](https://affpapa.org/nevibecode/skills/iphone-duo-camera.md) — скилл · 500 установок
- [xcode-project-setup](https://affpapa.org/nevibecode/skills/xcode-project-setup.md) — скилл · 130700 установок
- [expo-migrate-module](https://affpapa.org/nevibecode/skills/expo-migrate-module.md) — скилл · 19400 установок
- [clerk-swift](https://affpapa.org/nevibecode/skills/clerk-swift.md) — скилл · 14500 установок
- [swiftdata-pro](https://affpapa.org/nevibecode/skills/swiftdata-pro.md) — скилл · 9300 установок

Из того же набора: [dpearson2699/swift-ios-skills](https://affpapa.org/nevibecode/by/dpearson2699/swift-ios-skills.md) — 69 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md