Responder a acciones de botones en Flutter SDK

Si estás creando flows o paywalls con el builder de Adapty, es fundamental configurar los botones correctamente:

1. Añade un botón en el builder y asígnale una acción existente 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 existentes en tu código.

Cerrar flows y paywalls

Para añadir un botón que cierre tu flow o paywall, en el builder añade un botón y asígnale la acción Close. No se necesita código: la implementación predeterminada de flowViewDidPerformAction cierra la vista cuando recibe CloseAction.

Sobreescribe flowViewDidPerformAction si necesitas un comportamiento personalizado — por ejemplo, para cerrar también la vista al pulsar el botón de retroceso del sistema Android, como en v3:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
    switch (action) {
      case const CloseAction():
      case const AndroidSystemBackAction():
        view.dismiss();
        break;
      case OpenUrlAction(:final url, :final openIn):
        AdaptyUI().openUrl(url, openIn: openIn);
        break;
      default:
        break;
    }
}

Abrir URLs desde flows y paywalls

Para añadir un botón que abra un enlace (por ejemplo, Términos de uso o Política de privacidad), añade un botón en el builder, asígnale la acción Open URL e introduce la URL que quieres abrir. No se necesita código: la implementación predeterminada de flowViewDidPerformAction abre la URL de forma nativa mediante AdaptyUI().openUrl, respetando la configuración de navegador interno o externo del dashboard.

El comportamiento predeterminado es suficiente para la mayoría de los casos. Si aun así quieres abrir las URLs tú mismo, sobreescribe el handler:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
    switch (action) {
      case const CloseAction():
        view.dismiss();
        break;
      case OpenUrlAction(url: final url):
        // Open the URL in whatever way fits your app
        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 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 flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
    switch (action) {
      case CustomAction(action: 'login'):
        // Navigate to your login screen in whatever way fits your app
        break;
      default:
        break;
    }
}

Gestionar acciones personalizadas

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

1. En el builder, añade un botón, asígnale la acción Custom y dale un ID.
2. En el código de tu app, implementa un handler 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 flow o paywall:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
   switch (action) {
     case CustomAction(action: 'openNewPaywall'):
       // Display another flow or paywall
       break;
     default:
       break;
   }
}

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 existente 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 explica cómo gestionar acciones personalizadas y predefinidas en tu código.

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 handler para las acciones CloseAction y AndroidSystemBackAction.

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

Abrir URLs desde paywalls

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 quieras abrir.
2. En el código de tu app, implementa un handler 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(AdaptyUIPaywallView 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'):
        // Navigate to your login screen in whatever way fits your app
        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 has 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;
   }
}