Mostrar flows y paywalls - Flutter

Si has creado un flow o un paywall en el antiguo Paywall Builder, no necesitas preocuparte por renderizarlo en el código de tu app para mostrárselo al usuario. Un flow o paywall de este tipo contiene tanto lo que se debe mostrar como la forma en que debe mostrarse.

Warning

Esta guía es para flows y paywalls renderizados por Adapty. Para presentar paywalls personalizados, consulta Presentar paywalls personalizados.

El SDK de Flutter de Adapty ofrece dos formas de presentar flows y paywalls:

  • Pantalla independiente

  • Widget embebido

Presentar como pantalla independiente

Para mostrar un flow o paywall como pantalla independiente, usa el método view.present() sobre el view creado con el método createFlowView. Por defecto, al cerrar un view este se libera de la memoria, por lo que no puedes volver a mostrarlo. Si necesitas mostrarlo de nuevo, llama a createFlowView otra vez para crear una nueva instancia de view, o ciérralo sin liberarlo en SDK 4.1 y versiones posteriores.

try {
  await view.present();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Tip

¿Quieres ver un ejemplo real de cómo se integra el SDK de Adapty en una app móvil? Echa un vistazo a nuestras apps de ejemplo, que muestran la configuración completa, incluyendo la visualización de paywalls, la realización de compras y otras funcionalidades básicas.

Cerrar el flow o paywall

Cuando necesites cerrar el flow o paywall de forma programática, usa el método dismiss():

try {
  await view.dismiss();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Note

Cerrar una vista la elimina de la memoria: una vista cerrada ya no puede volver a mostrarse. Crea una nueva con createFlowView en su lugar.

A partir del SDK 4.1, pasa destroy: false para mantener la vista en memoria:

await view.dismiss(destroy: false);

Muestra esa vista de nuevo y el usuario regresa a la pantalla donde lo dejó, con el estado que el flow había acumulado. Una vista conservada de esta forma permanece en memoria hasta que la liberes.

A partir del SDK 4.3.0, cuando ya no necesites una vista conservada, libérala con destroy():

await view.dismiss(destroy: false);
// ...
await view.destroy();

destroy() también libera una vista que creaste pero nunca presentaste, y una vista de page-sheet que el usuario deslizó hacia abajo en iOS. No lo llames después de un dismiss() normal: esa vista ya está liberada y la llamada fallará con el error wrongParam. En versiones anteriores del SDK, presenta de nuevo la vista guardada y ciérrala con destroy: true para liberarla.

La acción de cierre predeterminada llama a view.dismiss(), lo que libera la vista aunque la hayas retenido antes con destroy: false. Para conservar una vista cuando el usuario la cierra, sobreescribe flowViewDidPerformAction y descarta la vista tú mismo. Este método se ejecuta para todos los flows y paywalls de tu app, así que compara view.id para conservar solo la vista que planeas volver a mostrar. Mantén el caso OpenUrlAction para preservar la apertura de URLs:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
  switch (action) {
    case const CloseAction():
      // keptView is the view your app stored to present again
      view.dismiss(destroy: view.id != keptView?.id);
      break;
    case OpenUrlAction(:final url, :final openIn):
      AdaptyUI().openUrl(url, openIn: openIn);
      break;
    default:
      break;
  }
}

Conserva el view que has obtenido: lo necesitas para presentar de nuevo el flow o paywall, y para liberarlo con destroy(). Cualquier otra llamada a view.dismiss() también libera la vista, incluida la llamada en flowViewDidReceiveError. Tras un error de vista, crea una nueva vista con createFlowView.

Mostrar diálogo

Usa este método en lugar de los diálogos de alerta nativos cuando se muestra un flow o una vista de paywall en Android. En Android, las alertas normales aparecen detrás de la vista, lo que las hace invisibles para los usuarios. Este método garantiza que el diálogo se muestre correctamente por encima del flow o el paywall en todas las plataformas.

try {
  final action = await view.showDialog(
    title: 'Close paywall?',
    content: 'You will lose access to exclusive offers.',
    primaryActionTitle: 'Stay',
    secondaryActionTitle: 'Close',
  );
  
  if (action == AdaptyUIDialogActionType.secondary) {
    // User confirmed - close the paywall
    await view.dismiss();
  }
  // If primary - do nothing, user stays
} catch (e) {
  // handle error
}

Configura el estilo de presentación en iOS

Configura cómo se presenta el flow o paywall en iOS pasando el parámetro iosPresentationStyle al método present(). El parámetro acepta los valores AdaptyUIIOSPresentationStyle.fullScreen (por defecto) o AdaptyUIIOSPresentationStyle.pageSheet.

try {
  await view.present(iosPresentationStyle: AdaptyUIIOSPresentationStyle.pageSheet);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

El usuario puede deslizar la hoja de página hacia abajo para cerrarla. La vista permanece en memoria sin llamar a dismiss(): preséntala de nuevo o, a partir del SDK 4.3.0, libérala con destroy().

Incorporar en la jerarquía de widgets

Para incorporar un flow o paywall dentro de tu árbol de widgets existente, usa el widget AdaptyUIFlowPlatformView directamente en tu jerarquía de widgets de Flutter.

AdaptyUIFlowPlatformView(
  flow: flow, // The flow object you fetched
  locale: 'en', // The localization to render the flow with
  onDidAppear: (view) {
  },
  onDidDisappear: (view) {
  },
  onDidPerformAction: (view, action) {
  },
  onDidSelectProduct: (view, productId) {
  },
  onDidStartPurchase: (view, product) {
  },
  onDidFinishPurchase: (view, product, purchaseResult) {
  },
  onDidFailPurchase: (view, product, error) {
  },
  onDidStartRestore: (view) {
  },
  onDidFinishRestore: (view, profile) {
  },
  onDidFailRestore: (view, error) {
  },
  onDidReceiveError: (view, error) {
  },
  onDidFailLoadingProducts: (view, error) {
  },
  onDidFinishWebPaymentNavigation: (view, product, error) {
  },
)
Note

Para que la vista de plataforma de Android funcione, asegúrate de que tu MainActivity extiende FlutterFragmentActivity:

class MainActivity : FlutterFragmentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}

Si has personalizado un paywall con el Paywall Builder, no necesitas preocuparte por renderizarlo en el código de tu app para mostrárselo al usuario. Ese tipo de paywall incluye tanto lo que debe mostrarse como la forma en que debe mostrarse.

Warning

Esta guía cubre solo los paywalls creados en el antiguo Paywall Builder para Adapty SDK 3.x. Requieren SDK v3.2.0 o posterior. Presentar un paywall creado para SDK 2.x o anterior, o un paywall personalizado, funciona de forma diferente.

El SDK de Adapty para Flutter ofrece dos formas de presentar paywalls:

  • Pantalla independiente

  • Widget integrado

Presentar como pantalla independiente

Para mostrar un paywall como pantalla independiente, usa el método view.present() en la view creada por el método createPaywallView. Cada view solo puede usarse una vez. Si necesitas mostrar el paywall de nuevo, llama a createPaywallView otra vez para crear una nueva instancia de view.

Warning

Reutilizar la misma view sin recrearla puede provocar un error AdaptyUIError.viewAlreadyPresented.

try {
  await view.present();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Tip

¿Quieres ver un ejemplo real de cómo se integra el SDK de Adapty en una app móvil? Echa un vistazo a nuestras apps de ejemplo, que muestran la configuración completa, incluyendo la visualización de paywalls, la realización de compras y otras funcionalidades básicas.

Cierra el paywall

Cuando necesites cerrar el paywall mediante código, usa el método dismiss():

try {
  await view.dismiss();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Mostrar un diálogo

Usa este método en lugar de los diálogos de alerta nativos cuando se muestra una vista de paywall en Android. En Android, las alertas normales aparecen detrás de la vista del paywall, lo que las hace invisibles para el usuario. Este método garantiza que el diálogo se muestre correctamente por encima del paywall en todas las plataformas.

try {
  final action = await view.showDialog(
    title: 'Close paywall?',
    content: 'You will lose access to exclusive offers.',
    primaryActionTitle: 'Stay',
    secondaryActionTitle: 'Close',
  );
  
  if (action == AdaptyUIDialogActionType.secondary) {
    // User confirmed - close the paywall
    await view.dismiss();
  }
  // If primary - do nothing, user stays
} catch (e) {
  // handle error
}

Configura el estilo de presentación en iOS

Configura cómo se muestra el paywall en iOS pasando el parámetro iosPresentationStyle al método present(). El parámetro acepta los valores AdaptyUIIOSPresentationStyle.fullScreen (por defecto) o AdaptyUIIOSPresentationStyle.pageSheet.

try {
  await view.present(iosPresentationStyle: AdaptyUIIOSPresentationStyle.pageSheet);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Insertar en la jerarquía de widgets

Para insertar un paywall dentro de tu árbol de widgets existente, utiliza el widget AdaptyUIPaywallPlatformView directamente en tu jerarquía de widgets de Flutter.

AdaptyUIPaywallPlatformView(
  paywall: paywall, // The paywall object you fetched
  onDidAppear: (view) {
  },
  onDidDisappear: (view) {
  },
  onDidPerformAction: (view, action) {
  },
  onDidSelectProduct: (view, productId) {
  },
  onDidStartPurchase: (view, product) {
  },
  onDidFinishPurchase: (view, product, purchaseResult) {
  },
  onDidFailPurchase: (view, product, error) {
  },
  onDidStartRestore: (view) {
  },
  onDidFinishRestore: (view, profile) {
  },
  onDidFailRestore: (view, error) {
  },
  onDidFailRendering: (view, error) {
  },
  onDidFailLoadingProducts: (view, error) {
  },
  onDidFinishWebPaymentNavigation: (view, product, error) {
  },
)
Note

Para que la vista de plataforma Android funcione, asegúrate de que tu MainActivity extienda FlutterFragmentActivity:

class MainActivity : FlutterFragmentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}