Показ флоу в режиме Observer — Kotlin Multiplatform

Если вы используете режим Observer, вся логика покупок лежит на вас. При этом интерфейс пейвола можно полностью делегировать Flow & Paywall Builder.

Разработайте экран в конструкторе, и SDK Adapty отрендерит его нативно. Обновляйте тексты, макет и цены в любой момент — без выпуска нового релиза.

В этом гайде показано, как отобразить флоу и обработать коллбэки покупки. Если Adapty выполняет покупки за вас, см. Отображение флоу и пейволов.

Прежде чем начать

Вам потребуется:

Реализация

В режиме Observer SDK не выполняет покупки самостоятельно. Когда пользователь нажимает кнопку покупки или восстановления во флоу, отрендеренном Adapty, SDK вызывает ваш AdaptyUIObserverModeResolver — выполните покупку или восстановление с помощью собственного кода.

  1. Реализуйте интерфейс 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 о процессе покупки или восстановления. Это необходимо для корректного поведения флоу, например для отображения загрузчика и прочего:

CallbackDescription
onStartPurchase()Коллбэк должен вызываться, чтобы уведомить AdaptyUI о начале покупки.
onFinishPurchase()Коллбэк должен вызываться, чтобы уведомить AdaptyUI о завершении покупки.
onStartRestore()Коллбэк должен вызываться, чтобы уведомить AdaptyUI о начале восстановления покупок.
onFinishRestore()Коллбэк должен вызываться, чтобы уведомить AdaptyUI о завершении восстановления покупок.

Флоу остаётся открытым, пока выполняется ваш код. Закройте его самостоятельно после успешной покупки или восстановления покупок.

После onFinishPurchase() флоу выполняет те же действия для результата, что бы ни произошло, включая отменённую покупку: действия When pending на iOS и действия When succeeded на Android. Любой экран, который зависит от результата покупки (например, экран благодарности), показывайте из своего кода — только ваш код знает результат. После onFinishRestore() флоу выполняет действия When restore completed, что бы ни произошло.

  1. Зарегистрируйте resolver до показа любого экрана:

    import com.adapty.kmp.AdaptyUI
    
    AdaptyUI.setObserverModeResolver(MyObserverModeResolver())

    Без зарегистрированного резолвера у флоу-вью нет способа передать покупку в ваш код, и ничего не происходит при нажатии пользователем кнопки покупки.

  2. Создайте и отобразите флоу-вью как обычно: получите флоу и создайте его вью, затем отобразите его. Дополнительные параметры не нужны — как только резолвер зарегистрирован, каждый флоу, отрисованный Adapty, направляет покупки и восстановления через него.

Warning

Не забудьте сообщить о транзакции и связать её с пейволом. В противном случае Adapty не распознает транзакцию и не определит исходный пейвол покупки.