Показ флоу в режиме Observer — Kotlin Multiplatform
Если вы используете режим Observer, вся логика покупок лежит на вас. При этом интерфейс пейвола можно полностью делегировать Flow & Paywall Builder.
Разработайте экран в конструкторе, и SDK Adapty отрендерит его нативно. Обновляйте тексты, макет и цены в любой момент — без выпуска нового релиза.
В этом гайде показано, как отобразить флоу и обработать коллбэки покупки. Если Adapty выполняет покупки за вас, см. Отображение флоу и пейволов.
Прежде чем начать
Вам потребуется:
- Adapty Kotlin Multiplatform SDK 4.0 (beta) или новее: Более ранние версии не могут отображать флоу. Чтобы перенести существующее приложение, воспользуйтесь гайдом по миграции.
withObserverMode(true)в конфигурационном билдере: Смотрите гайд по установке Kotlin Multiplatform SDK.- Первоначальная интеграция со стором: Настройте Adapty с App Store и с Google Play.
- Опубликованный флоу с продуктами: Создайте его в Flow & Paywall Builder и назначьте ему продукты.
- Плейсмент для флоу: Создайте плейсмент и назначьте ему флоу.
- Флоу, загруженный в приложении: Получите флоу и его конфигурацию перед отображением.
Реализация
В режиме Observer SDK не выполняет покупки самостоятельно. Когда пользователь нажимает кнопку покупки или восстановления во флоу, отрендеренном Adapty, SDK вызывает ваш AdaptyUIObserverModeResolver — выполните покупку или восстановление с помощью собственного кода.
-
Реализуйте интерфейс
AdaptyUIObserverModeResolver:import com.adapty.kmp.AdaptyUIObserverModeResolver import com.adapty.kmp.models.AdaptyPaywallProduct import com.adapty.kmp.models.AdaptyUIFlowView class MyObserverModeResolver : AdaptyUIObserverModeResolver { override fun observerModeDidInitiatePurchase( view: AdaptyUIFlowView, product: AdaptyPaywallProduct, onStartPurchase: () -> Unit, onFinishPurchase: () -> Unit ) { onStartPurchase() // the view shows its loading indicator // make the purchase with your own code, // then report the transaction to Adapty and call: onFinishPurchase() // the view hides the loading indicator } override fun observerModeDidInitiateRestore( view: AdaptyUIFlowView, onStartRestore: () -> Unit, onFinishRestore: () -> Unit ) { onStartRestore() // restore purchases with your own code, then: onFinishRestore() } }Метод
observerModeDidInitiatePurchaseсообщает, что пользователь инициировал покупку, аobserverModeDidInitiateRestore— что пользователь инициировал восстановление покупок. В ответ на эти события запустите свой кастомный флоу покупки или восстановления.
Также не забудьте вызвать следующие коллбэки, чтобы уведомить AdaptyUI о процессе покупки или восстановления. Это необходимо для корректного поведения флоу, например для отображения загрузчика и прочего:
| Callback | Description |
|---|---|
| onStartPurchase() | Коллбэк должен вызываться, чтобы уведомить AdaptyUI о начале покупки. |
| onFinishPurchase() | Коллбэк должен вызываться, чтобы уведомить AdaptyUI о завершении покупки. |
| onStartRestore() | Коллбэк должен вызываться, чтобы уведомить AdaptyUI о начале восстановления покупок. |
| onFinishRestore() | Коллбэк должен вызываться, чтобы уведомить AdaptyUI о завершении восстановления покупок. |
Флоу остаётся открытым, пока выполняется ваш код. Закройте его самостоятельно после успешной покупки или восстановления покупок.
После onFinishPurchase() флоу выполняет те же действия для результата, что бы ни произошло, включая отменённую покупку: действия When pending на iOS и действия When succeeded на Android. Любой экран, который зависит от результата покупки (например, экран благодарности), показывайте из своего кода — только ваш код знает результат. После onFinishRestore() флоу выполняет действия When restore completed, что бы ни произошло.
-
Зарегистрируйте resolver до показа любого экрана:
import com.adapty.kmp.AdaptyUI AdaptyUI.setObserverModeResolver(MyObserverModeResolver())Без зарегистрированного резолвера у флоу-вью нет способа передать покупку в ваш код, и ничего не происходит при нажатии пользователем кнопки покупки.
-
Создайте и отобразите флоу-вью как обычно: получите флоу и создайте его вью, затем отобразите его. Дополнительные параметры не нужны — как только резолвер зарегистрирован, каждый флоу, отрисованный Adapty, направляет покупки и восстановления через него.
Не забудьте сообщить о транзакции и связать её с пейволом. В противном случае Adapty не распознает транзакцию и не определит исходный пейвол покупки.