<!-- Canonical: https://docs.shopstory.live/docs/guide/mobile-sdk-legacy -->

# Ручное размещение плеера на iOS

Этот путь нужен, когда приложение само размещает полноэкранный плеер и окно Follow Me. Для готовой презентации начните с [управляемого плеера iOS](<https://docs.shopstory.live/docs/guide/mobile-sdk-ios#%D0%BF%D0%B5%D1%80%D0%B2%D1%8B%D0%B9-%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA-%D0%BD%D0%B0-uikit>) или [Flutter на iOS](<https://docs.shopstory.live/docs/guide/mobile-sdk-flutter#%D0%BF%D0%B5%D1%80%D0%B2%D0%BE%D0%B5-%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE-%D0%B8%D0%B7-%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80%D0%B0>).

## Перенесите просмотр в Follow Me

1. После конфигурации SDK удерживайте один `ShopStoryPlayerCoordinator` и один `ShopStoryFloatingPlayerController` на время просмотра. Объект приложения также удерживает делегат координатора.
2. Поместите представление плеера в полноэкранный контейнер через `attach(to:)` и загрузите полученный от SDK `entrypoint` через `load(entrypoint:)`.
3. Когда роутер открыл разрешённую PDP, перенесите тот же `playerView` через `detach()` и `attach(to:)`. Та же сессия сохраняет позицию записи. `load(entrypoint:)` вызывается при начале просмотра.
4. На корзине и других запрещённых экранах сообщите фактическую поверхность, скройте окно и приостановите просмотр. На обратном переходе сначала сообщите новый видимый экран, затем проверьте, разрешено ли снова показать окно.
5. Когда зритель закрыл плеер, завершите сессию через `teardown()` и освободите контейнер. Следующее открытие получает новый координатор. Завершайте сессию также при удалённом отключении SDK.

**Один player view, разные контейнеры**Условный интерфейс. Карточкой товара и корзиной управляет приложение.

Host удерживает одну session и один `ShopStoryPlayerCoordinator`.

**Full-screen container**

`attach(to:)`, затем `load(entrypoint:)` при открытии session.

Нажатие на товар: тот же `playerView`
`detach()` → `attach(to:)`

**PDP с Follow Me**

Новый контейнер, та же session. Без повторного `load` и без `teardown`.

**Управление Follow Me**

Элементы управления окна крупно.

- Крестик слева — закрыть видео и завершить session.
- Стрелка справа — скрыть окно к краю. Кнопка у края возвращает его.
- Нажатие на видео — вернуться в полный плеер.

**Cart и другие заблокированные экраны**

Host вызывает `setCurrentSurface`. По runtime policy ставит playback на паузу и скрывает Follow Me.

Возврат на разрешённый экран → снова применяет `shouldShowFollowMePlayer()`. Session не пересоздаётся.

Закрытие → `teardown()` → конец session. Следующее открытие создаёт новую session.

[Иллюстрация в полном размере](<https://docs.shopstory.live/img/guide-illustrations/ios-session-brand-v4.webp>) · [Записи работы SDK](<https://docs.shopstory.live/docs/guide/mobile-sdk#mobile-demo-handoff-caption>).

### Методы координатора

| Метод | Когда вызывать |
| --- | --- |
| `attach(to:)` | При размещении представления в контейнере приложения |
| `load(entrypoint:)` | При открытии разрешённого товарного видео |
| `detach()` | При переносе представления. Сессия сохраняется |
| `pausePlayback(reason:)` и `resumePlayback()` | Когда приложение приостанавливает просмотр или снимает собственную паузу |
| `teardown()` | При завершении сессии |

### Разрешение на показ и геометрия

Сообщайте фактический верхний экран через `setCurrentSurface(_:allowed:)`. Проверьте `shouldShowFollowMePlayer()`, прежде чем показывать окно. Геометрию вычисляет `followMeGeometry(for:mediaOrientation:)`. Для перетаскивания, скрытия у края и возврата используйте `ShopStoryManagedFloatingPlayerContainer` и `ShopStoryFloatingPlayerControlOverlay`.

### Действия с товаром

Координатор передаёт `ShopStoryProductAction` делегату `ShopStoryPlayerCoordinatorDelegate`. Для перехода сопоставьте `feedProductId` с каталогом приложения и откройте PDP через свой роутер. Для прямого добавления подтверждайте покупателю результат по ответу системы магазина. [Интеграция корзины](<https://docs.shopstory.live/docs/guide/mobile-sdk-cart>)

### События просмотра

`pageLoaded` сообщает о загрузке страницы плеера. Начало воспроизведения проверяйте отдельно. Обрабатывайте `closeRequested` и `runtimePolicyDisabled` в коде, который владеет сессией, чтобы вовремя освободить контейнер.

Полный пример с UIKit и SwiftUI приведён в разделах 7–9 файла `ios/docs/INTEGRATION.md` из поставки. [Навигация и допустимые экраны](<https://docs.shopstory.live/docs/guide/mobile-sdk-navigation#%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B8%D1%82%D0%B5-%D1%84%D0%B0%D0%BA%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8-%D0%B2%D0%B8%D0%B4%D0%B8%D0%BC%D1%8B%D0%B9-%D1%8D%D0%BA%D1%80%D0%B0%D0%BD>) · [Проверки перед выпуском](<https://docs.shopstory.live/docs/guide/mobile-sdk-releases#%D0%BF%D1%80%D0%B8%D1%91%D0%BC%D0%BA%D0%B0-%D0%BF%D0%B5%D1%80%D0%B5%D0%B4-%D0%B2%D1%8B%D0%BF%D1%83%D1%81%D0%BA%D0%BE%D0%BC>)
