Présenter des flows en mode Observateur - Kotlin Multiplatform

Si vous utilisez le mode Observateur, vous êtes responsable de votre propre logique d’achat. Mais vous pouvez déléguer l’interface du paywall au Flow & Paywall Builder.

Concevez l’écran dans le builder, et le SDK Adapty le rend nativement. Modifiez le contenu, la mise en page et les tarifs quand vous le souhaitez, sans soumettre de mise à jour.

Ce guide explique comment afficher un flow et gérer les callbacks d’achat. Si Adapty gère les achats à votre place, consultez Afficher les flows et paywalls à la place.

Avant de commencer

Vous avez besoin de :

Implémentation

En mode Observer, le SDK n’effectue pas les achats à votre place. Lorsqu’un utilisateur appuie sur le bouton d’achat ou de restauration dans un flow affiché par Adapty, le SDK appelle votre AdaptyUIObserverModeResolver à la place — effectuez l’achat ou la restauration avec votre propre code à cet endroit.

  1. Implémentez l’interface 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()
        }
    }

    Le callback observerModeDidInitiatePurchase vous informe que l’utilisateur a initié un achat, et observerModeDidInitiateRestore — que l’utilisateur a initié une restauration. Déclenchez votre flow d’achat ou de restauration personnalisé en réponse.

N’oubliez pas non plus d’appeler les callbacks suivants pour notifier AdaptyUI de l’avancement de l’achat ou de la restauration. Cela est nécessaire pour le bon fonctionnement du flow, notamment pour afficher le loader :

CallbackDescription
onStartPurchase()Ce callback doit être invoqué pour notifier AdaptyUI que l’achat a démarré.
onFinishPurchase()Ce callback doit être invoqué pour notifier AdaptyUI que l’achat est terminé.
onStartRestore()Ce callback doit être invoqué pour notifier AdaptyUI que la restauration a démarré.
onFinishRestore()Ce callback doit être invoqué pour notifier AdaptyUI que la restauration est terminée.

Le flow reste ouvert pendant l’exécution de votre code. Fermez-le vous-même dès qu’un achat ou une restauration d’achat réussit.

Après onFinishPurchase(), le flow exécute les mêmes actions de résultat quel que soit le résultat, y compris en cas d’annulation : les actions When pending sur iOS et les actions When succeeded sur Android. Affichez tout écran dépendant du résultat de l’achat depuis votre code : seul votre code connaît le résultat. Après onFinishRestore(), le flow exécute les actions When restore completed, quel que soit le résultat.

  1. Enregistrez le resolver avant d’afficher n’importe quel écran :

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

    Sans résolveur enregistré, la vue du flow n’a aucun moyen de transmettre l’achat à votre code, et rien ne se passe quand l’utilisateur appuie sur le bouton d’achat.

  2. Créez et affichez la vue du flow comme d’habitude : récupérez le flow et créez sa vue, puis affichez-la. Aucun paramètre supplémentaire n’est nécessaire — une fois le résolveur enregistré, chaque flow rendu par Adapty achemine les achats et les restaurations via celui-ci.

Warning

N’oubliez pas de signaler la transaction et de l’associer au paywall. Sinon, Adapty ne reconnaîtra pas la transaction et ne pourra pas déterminer le paywall source de l’achat.