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 :

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 :

    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.

    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.

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

    AdaptyUI().setObserverModeResolver(MyObserverModeResolver());
  3. 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 rendu par Adapty route les achats et les restaurations à travers lui.

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.