Présenter des flows en mode Observateur - Kotlin Multiplatform

Si vous avez personnalisé un flow ou un paywall avec le builder, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Un tel flow ou paywall contient à la fois ce qui doit être affiché et comment cela doit l’être.

Warning

Cette section concerne uniquement le mode Observer. Si vous ne travaillez pas en mode Observer, consultez la rubrique Afficher les flows et paywalls.

Info

Cette fonctionnalité nécessite Adapty Kotlin Multiplatform SDK 4.0 (bêta) ou version ultérieure — elle n’était auparavant disponible que dans les SDK natifs iOS et Android. Consultez le guide de migration pour effectuer la mise à niveau.

Tip

Créez le flow lui-même dans le Flow Builder.

Avant de commencer à présenter les flows (Cliquez pour développer)
  1. Configurez l’intégration initiale d’Adapty avec l’App Store et avec Google Play. 2. Installez et configurez le SDK Adapty. Assurez-vous d’appeler withObserverMode(true) dans le constructeur de configuration. Consultez le guide d’installation du SDK Kotlin Multiplatform. 3. Créez des produits dans l’Adapty Dashboard. 4. Configurez des flows ou des paywalls dans les builders et assignez-leur des produits. 5. Créez des placements et assignez-leur vos flows ou paywalls. 6. Récupérez les flows et leur configuration dans le code de votre application mobile.

En mode Observateur, le SDK n’effectue pas les achats à votre place. Lorsqu’un utilisateur appuie sur le bouton d’achat ou de restauration dans un flow ou un paywall rendu par Adapty, le SDK appelle votre AdaptyUIObserverModeResolver — 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()
        }
    }

La méthode observerModeDidInitiatePurchase vous informe que l’utilisateur a lancé un achat, et observerModeDidInitiateRestore — que l’utilisateur a lancé 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 informer 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 chargement :

CallbackDescription
onStartPurchase()Le callback doit être appelé pour notifier AdaptyUI que l’achat a commencé.
onFinishPurchase()Le callback doit être appelé pour notifier AdaptyUI que l’achat est terminé.
onStartRestore()Le callback doit être appelé pour notifier AdaptyUI que la restauration a commencé.
onFinishRestore()Le callback doit être appelé 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 après un achat ou une restauration réussie.

  1. Enregistrez le resolver avant d’afficher un quelconque écran :

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

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

  2. Créez et affichez le flow view 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 resolver enregistré, chaque flow ou paywall rendu par Adapty achemine les achats et les restaurations à travers lui.

Warning

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