Presentar onboardings en Unity SDK

Warning

Los onboardings están obsoletos a partir de Adapty SDK v4. Usa flows en su lugar: a diferencia de los onboardings, que se ejecutan dentro de un WebView, los flows se renderizan de forma nativa en el dispositivo — animaciones más fluidas, una apariencia nativa consistente, tiempos de carga más rápidos y sin dependencia del runtime de WebView.

Si has personalizado un onboarding con el builder, no necesitas preocuparte por renderizarlo en el código de tu app Unity para mostrárselo al usuario. Ese onboarding ya incluye tanto el contenido que debe aparecer como la forma en que debe presentarse.

Antes de empezar, asegúrate de que:

  1. Tienes instalado el SDK de Adapty para Unity 3.14.0 o posterior.
  2. Has creado un onboarding.
  3. Has añadido el onboarding a un placement.

Para mostrar un onboarding, utiliza el método view.Present() sobre el view creado por el método CreateOnboardingView. Cada view solo puede usarse una vez. Si necesitas mostrar el paywall de nuevo, llama a CreateOnboardingView otra vez para crear una nueva instancia de view.

Warning

Reutilizar el mismo view sin recrearlo puede provocar un error AdaptyUIError.viewAlreadyPresented.

view.Present((presentError) => {
    if (presentError != null) {
        // handle the error
    }
};

Configurar el estilo de presentación en iOS

Configura cómo se presenta el onboarding en iOS pasando el parámetro iosPresentationStyle al método Present(). El parámetro acepta los valores AdaptyUIIOSPresentationStyle.FullScreen (predeterminado) o AdaptyUIIOSPresentationStyle.PageSheet.

view.Present(AdaptyUIIOSPresentationStyle.PageSheet, (error) => {
    // handle the error
});
Important

La personalización de cómo se abren los enlaces en los onboardings es compatible a partir de Adapty SDK v3.15.

Por defecto, los enlaces en los onboardings se abren en un navegador integrado en la app, lo que ofrece una experiencia fluida al mostrar páginas web dentro de tu aplicación sin cambiar de app.

Para abrir los enlaces en un navegador externo, pasa AdaptyWebPresentation.ExternalBrowser al método CreateOnboardingView:

AdaptyUI.CreateOnboardingView(
    onboarding,
    AdaptyWebPresentation.ExternalBrowser, // default — InAppBrowser
    (view, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // present the onboarding view
        view.Present((presentError) => {
            if (presentError != null) {
                // handle the error
            }
        });
    }
);

Opciones disponibles:

  • AdaptyWebPresentation.InAppBrowser - Abre los enlaces en un navegador integrado (por defecto)
  • AdaptyWebPresentation.ExternalBrowser - Abre los enlaces en el navegador externo del dispositivo