Présenter les flows en mode Observer - 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 pour l’afficher à l’utilisateur. Un tel flow ou paywall contient à la fois ce qui doit être affiché et comment il doit l’être.
Cette section concerne uniquement le mode Observer. Si vous ne travaillez pas en mode Observer, consultez la rubrique Afficher les flows et paywalls.
Cette fonctionnalité nécessite le SDK Adapty Kotlin Multiplatform 4.0 (beta) ou une 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.
Avant de commencer à présenter des flows (Cliquez pour développer)
- Configurez l’intégration initiale d’Adapty avec l’App Store et avec Google Play.
- Installez et configurez le SDK Adapty. Assurez-vous d’appeler
withObserverMode(true)dans le builder de configuration. Consultez le guide d’installation du SDK Kotlin Multiplatform. - Créez des produits dans l’Adapty Dashboard.
- Configurez des flows ou des paywalls dans les builders et associez-leur des produits.
- Créez des placements et assignez-leur vos flows ou paywalls.
- Récupérez les flows et leur configuration dans le code de votre application.
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 ou paywall rendu par Adapty, le SDK appelle votre AdaptyUIObserverModeResolver à la place — effectuez l’achat ou la restauration avec votre propre code à cet endroit.
-
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
observerModeDidInitiatePurchasevous informe que l’utilisateur a initié un achat, etobserverModeDidInitiateRestore— 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’invoquer 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 l’affichage du chargement :
Callback Description 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 après un achat ou une restauration réussi.
-
Enregistrez le resolver avant d’afficher un é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.
-
Créez et présentez la vue du flow comme d’habitude : récupérez le flow et créez sa vue, puis présentez-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.
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.