Ручное размещение плеера на iOS
Этот путь нужен, когда приложение само размещает полноэкранный плеер и окно Follow Me. Для готовой презентации начните с управляемого плеера iOS или Flutter на iOS.
Перенесите просмотр в Follow Me
- После конфигурации SDK удерживайте один
ShopStoryPlayerCoordinatorи одинShopStoryFloatingPlayerControllerна время просмотра. Объект приложения также удерживает делегат координатора. - Поместите представление плеера в полноэкранный контейнер через
attach(to:)и загрузите полученный от SDKentrypointчерезload(entrypoint:). - Когда роутер открыл разрешённую PDP, перенесите тот же
playerViewчерезdetach()иattach(to:). Та же сессия сохраняет позицию записи.load(entrypoint:)вызывается при начале просмотра. - На корзине и других запрещённых экранах сообщите фактическую поверхность, скройте окно и приостановите просмотр. На обратном переходе сначала сообщите новый видимый экран, затем проверьте, разрешено ли снова показать окно.
- Когда зритель закрыл плеер, завершите сессию через
teardown()и освободите контейнер. Следующее открытие получает новый координатор. Завершайте сессию также при удалённом отключении SDK.
Host удерживает одну session и один ShopStoryPlayerCoordinator.
attach(to:), затем load(entrypoint:) при открытии session.
playerViewdetach() → attach(to:)Новый контейнер, та же session. Без повторного load и без teardown.
Элементы управления окна крупно.
- Крестик слева — закрыть видео и завершить session.
- Стрелка справа — скрыть окно к краю. Кнопка у края возвращает его.
- Нажатие на видео — вернуться в полный плеер.
Host вызывает setCurrentSurface. По runtime policy ставит playback на паузу и скрывает Follow Me.
Возврат на разрешённый экран → снова применяет shouldShowFollowMePlayer(). Session не пересоздаётся.
Закрытие → teardown() → конец session. Следующее открытие создаёт новую session.
Методы координатора
| Метод | Когда вызывать |
|---|---|
attach(to:) | При размещении представления в контейнере приложения |
load(entrypoint:) | При открытии разрешённого товарного видео |
detach() | При переносе представления. Сессия сохраняется |
pausePlayback(reason:) и resumePlayback() | Когда приложение приостанавливает просмотр или снимает собственную паузу |
teardown() | При завершении сессии |
Разрешение на показ и геометрия
Сообщайте фактический верхний экран через setCurrentSurface(_:allowed:). Проверьте shouldShowFollowMePlayer(), прежде чем показывать окно. Геометрию вычисляет followMeGeometry(for:mediaOrientation:). Для перетаскивания, скрытия у края и возврата используйте ShopStoryManagedFloatingPlayerContainer и ShopStoryFloatingPlayerControlOverlay.
Действия с товаром
Координатор передаёт ShopStoryProductAction делегату ShopStoryPlayerCoordinatorDelegate. Для перехода сопоставьте feedProductId с каталогом приложения и откройте PDP через свой роутер. Для прямого добавления подтверждайте покупателю результат по ответу системы магазина. Интеграция корзины
События просмотра
pageLoaded сообщает о загрузке страницы плеера. Начало воспроизведения проверяйте отдельно. Обрабатывайте closeRequested и runtimePolicyDisabled в коде, который владеет сессией, чтобы вовремя освободить контейнер.
Полный пример с UIKit и SwiftUI приведён в разделах 7–9 файла ios/docs/INTEGRATION.md из поставки. Навигация и допустимые экраны · Проверки перед выпуском
