Presentar flows en modo Observer en Flutter SDK

Si usas el modo Observer, eres responsable de tu propia lógica de compras. Pero puedes delegar la UI del paywall al Flow & Paywall Builder.

Diseña la pantalla en el builder y el SDK de Adapty la renderiza de forma nativa. Actualiza los textos, el diseño y los precios cuando quieras, sin publicar una nueva versión de la app.

Esta guía explica cómo presentar un flow y gestionar los callbacks de compra. Si Adapty gestiona las compras por ti, consulta Mostrar flows y paywalls.

Antes de empezar

Necesitas:

Implementación

En el modo Observer, el SDK no realiza compras por ti. Cuando un usuario pulsa el botón de compra o restauración en un flow renderizado por Adapty, el SDK llama a tu AdaptyUIObserverModeResolver en su lugar — realiza la compra o restauración con tu propio código allí.

  1. Implementa el 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();
      }
    }

    El método observerModeDidInitiatePurchase te informa de que el usuario ha iniciado una compra, y observerModeDidInitiateRestore — de que el usuario ha iniciado una restauración. Activa tu flow personalizado de compra o restauración en respuesta.

Recuerda también invocar los siguientes callbacks para notificar a AdaptyUI sobre el proceso de compra o restauración. Esto es necesario para el comportamiento correcto del flow, como mostrar el indicador de carga, entre otras cosas:

CallbackDescripción
onStartPurchase()El callback debe invocarse para notificar a AdaptyUI que la compra ha comenzado.
onFinishPurchase()El callback debe invocarse para notificar a AdaptyUI que la compra ha finalizado.
onStartRestore()El callback debe invocarse para notificar a AdaptyUI que la restauración ha comenzado.
onFinishRestore()El callback debe invocarse para notificar a AdaptyUI que la restauración ha finalizado.

Después de onFinishPurchase(), el flow ejecuta las mismas acciones de resultado independientemente de lo que haya ocurrido, incluida una compra cancelada: las acciones When pending en iOS y las acciones When succeeded en Android. Muestra cualquier pantalla que dependa del resultado de la compra desde tu código: solo tu código conoce el resultado. Después de onFinishRestore(), el flow ejecuta las acciones When restore completed, independientemente de lo que haya ocurrido.

  1. Registra el resolver antes de mostrar cualquier pantalla:

    AdaptyUI().setObserverModeResolver(MyObserverModeResolver());
  2. Crea y presenta la vista del flow de la manera habitual: obtén el flow y crea su vista y luego preséntalo. No se necesitan parámetros adicionales — una vez registrado el resolver, cada flow renderizado por Adapty enruta las compras y restauraciones a través de él.

Warning

No olvides informar la transacción y asociarla con el paywall. De lo contrario, Adapty no reconocerá la transacción y no podrá determinar el paywall de origen de la compra.