Présenter des flows en mode Observer dans le SDK Flutter
Si vous avez personnalisé un flow ou un paywall avec le builder, vous n’avez pas besoin de vous soucier du rendu dans votre code d’application mobile pour l’afficher à l’utilisateur. Ce type de 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 des flows & paywalls.
Cette fonctionnalité nécessite Adapty Flutter SDK 4.0 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.
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 de définir le paramètre
observerModesurtrue. Consultez le guide d’installation du SDK Flutter. - Créez des produits dans l’Adapty Dashboard.
- Configurez des flows ou des paywalls dans les builders et assignez-leur des produits.
- Créez des placements et assignez-leur vos flows ou paywalls.
- Récupérez les flows et leur configuration dans votre code d’application mobile.
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’
AdaptyUIObserverModeResolver:class MyObserverModeResolver extends AdaptyUIObserverModeResolver { @override void observerModeDidInitiatePurchase( AdaptyUIFlowView view, AdaptyPaywallProduct product, void Function() onStartPurchase, void Function() onFinishPurchase, ) { onStartPurchase(); // the view shows its loading indicator // make the purchase with your own code, then: onFinishPurchase(); // the view hides the loading indicator } @override void observerModeDidInitiateRestore( AdaptyUIFlowView view, void Function() onStartRestore, void Function() onFinishRestore, ) { 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 pour afficher le chargement, entre autres :
Callback Description onStartPurchase() Ce callback doit être invoqué pour notifier AdaptyUI que l’achat a commencé. 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 commencé. onFinishRestore() Ce callback doit être invoqué pour notifier AdaptyUI que la restauration est terminée. -
Enregistrez le resolver avant de présenter tout écran :
AdaptyUI().setObserverModeResolver(MyObserverModeResolver()); -
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 par son intermédiaire.
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.