Présenter les flows en mode Observer dans le SDK Flutter

Si vous utilisez le mode Observer, 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 restitue nativement. Mettez à jour les textes, la mise en page et les tarifs quand vous le souhaitez, sans publier de nouvelle version de l’application.

Ce guide explique comment présenter 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 :

• Adapty Flutter SDK 4.0 ou version ultérieure : les versions antérieures ne peuvent pas afficher les flows. Pour migrer une application existante, consultez le guide de migration.
• observerMode défini sur true : consultez le guide d’installation du SDK Flutter.
• Intégration initiale avec les stores : configurez Adapty avec l’App Store et avec Google Play.
• Un flow publié avec des produits : créez-le dans le Flow & Paywall Builder et associez-y des produits.
• Un placement pour votre flow : créez un placement et assignez-y votre flow.
• Le flow récupéré dans votre application : récupérez le flow et sa configuration avant de l’afficher.

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 rendu par Adapty, le SDK appelle votre AdaptyUIObserverModeResolver — effectuez l’achat ou la restauration avec votre propre code à cet endroit.

1. Implémentez le 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();
     }
   }

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’invoquer les callbacks suivants pour notifier AdaptyUI de l’avancement de l’achat ou de la restauration. Cela est nécessaire pour que le flow fonctionne correctement, notamment pour afficher le chargement, entre autres :

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

   AdaptyUI().setObserverModeResolver(MyObserverModeResolver());

3. 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 rendu par Adapty achemine les achats et les restaurations à travers lui.