Перейти к основному содержимому

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

Этот путь нужен, когда приложение само размещает полноэкранный плеер и окно Follow Me. Для готовой презентации начните с управляемого плеера iOS или Flutter на iOS.

Перенесите просмотр в 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.

Иллюстрация в полном размере · Записи работы SDK.

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

МетодКогда вызывать
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 из поставки. Навигация и допустимые экраны · Проверки перед выпуском