Responder a las acciones de botones en el SDK de Flutter

Si estás creando paywalls con el Paywall Builder de Adapty, es fundamental configurar los botones correctamente:

  1. Añade un botón en el Paywall Builder y asígnale una acción predefinida o crea un ID de acción personalizado.
  2. Escribe código en tu app para gestionar cada acción que hayas asignado.

Esta guía muestra cómo gestionar acciones personalizadas y predefinidas en tu código.

Solo las compras y restauraciones se gestionan automáticamente. El resto de acciones de botones, como cerrar paywalls o abrir enlaces, requieren implementar las respuestas correspondientes en el código de la app.

Cerrar paywalls

Para añadir un botón que cierre tu paywall:

  1. En el Paywall Builder, añade un botón y asígnale la acción Close.
  2. En el código de tu app, implementa un manejador para las acciones CloseAction y AndroidSystemBackAction.

En el SDK de Flutter, las acciones CloseAction y AndroidSystemBackAction cierran el paywall por defecto. Sin embargo, puedes sobrescribir este comportamiento en tu código si lo necesitas. Por ejemplo, cerrar un paywall podría disparar la apertura de otro.

void paywallViewDidPerformAction(AdaptyUIPaywallView view, AdaptyUIAction action) {
    switch (action) {
      case const CloseAction():
      case const AndroidSystemBackAction():
        view.dismiss();
        break;
      default:
        break;
    }
}

Abrir URLs desde paywalls

Si quieres añadir un grupo de enlaces (por ejemplo, términos de uso y restauración de compras), añade un elemento Link en el Paywall Builder y gestiónalo de la misma manera que los botones con la acción Open URL.

Para añadir un botón que abra un enlace desde tu paywall (por ejemplo, Terms of use o Privacy policy):

  1. En el Paywall Builder, añade un botón, asígnale la acción Open URL e introduce la URL que quieres abrir.
  2. En el código de tu app, implementa un manejador para la acción openUrl que abra la URL recibida en un navegador.
// You have to install url_launcher plugin in order to handle urls:
// https://pub.dev/packages/url_launcher

void paywallViewDidPerformAction(AdaptyUIView view, AdaptyUIAction action) {
    switch (action) {
      case OpenUrlAction(url: final url):
        final Uri uri = Uri.parse(url);
        launchUrl(uri, mode: LaunchMode.inAppBrowserView);
        break;
      default:
        break;
    }
}

Iniciar sesión en la app

Para añadir un botón que permita a los usuarios iniciar sesión en tu app:

  1. En el Paywall Builder, añade un botón y asígnale la acción Login.
  2. En el código de tu app, implementa un manejador para la acción login que identifique a tu usuario.
void paywallViewDidPerformAction(AdaptyUIPaywallView view, AdaptyUIAction action) {
    switch (action) {
      case CustomAction(action: 'login'):
        // Handle login action
        Navigator.of(context).push(MaterialPageRoute(builder: (context) => LoginScreen()));
        break;
      default:
        break;
    }
}

Gestionar acciones personalizadas

Para añadir un botón que gestione cualquier otra acción:

  1. En el Paywall Builder, añade un botón, asígnale la acción Custom y asígnale un ID.
  2. En el código de tu app, implementa un manejador para el ID de acción que hayas creado.

Por ejemplo, si tienes otro conjunto de ofertas de suscripción o compras únicas, puedes añadir un botón que muestre otro paywall:

void paywallViewDidPerformAction(AdaptyUIPaywallView view, AdaptyUIAction action) {
   switch (action) {
     case CustomAction(action: 'openNewPaywall'):
       // Display another paywall
       break;
     default:
       break;
   }
}