Présenter les onboardings dans le SDK Unity

Les onboardings sont dépréciés dans le SDK v4 et seront supprimés dans une prochaine version. Ils ne reçoivent plus de correctifs ni d’améliorations. Utilisez les flows à la place : contrairement aux onboardings, qui s’exécutent dans une WebView, les flows s’affichent nativement sur l’appareil — offrant des animations plus fluides, un rendu natif cohérent, des temps de chargement plus rapides et aucune dépendance à un runtime WebView. Consultez Obtenir des flows et paywalls et Afficher des flows et paywalls pour commencer.

Si vous avez personnalisé un onboarding avec le builder, vous n’avez pas besoin de vous soucier de son rendu dans votre code Unity pour l’afficher à l’utilisateur. Un tel onboarding contient à la fois ce qui doit être affiché et comment cela doit l’être.

Avant de commencer, assurez-vous que :

Vous avez installé Adapty Unity SDK 3.14.0 ou version ultérieure.
Vous avez créé un onboarding.
Vous avez ajouté l’onboarding à un placement.

Pour afficher un onboarding, utilisez la méthode view.Present() sur la view créée par la méthode CreateOnboardingView. Chaque view ne peut être utilisée qu’une seule fois. Si vous devez afficher le paywall à nouveau, appelez CreateOnboardingView une nouvelle fois pour créer une nouvelle instance de view.

Réutiliser la même view sans la recréer peut entraîner une erreur AdaptyUIError.viewAlreadyPresented.

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

Configurer le style de présentation iOS

Configurez la façon dont l’onboarding est présenté sur iOS en passant le paramètre iosPresentationStyle à la méthode Present(). Le paramètre accepte les valeurs AdaptyUIIOSPresentationStyle.FullScreen (par défaut) ou AdaptyUIIOSPresentationStyle.PageSheet.

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

Personnaliser l’ouverture des liens dans les onboardings

La personnalisation de l’ouverture des liens dans les onboardings est prise en charge à partir du SDK Adapty v3.15.

Par défaut, les liens dans les onboardings s’ouvrent dans un navigateur intégré à l’application, offrant une expérience fluide en affichant les pages web directement dans votre application sans changer d’app.

Pour ouvrir les liens dans un navigateur externe à la place, passez AdaptyWebPresentation.ExternalBrowser à la méthode 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
            }
        });
    }
);

Options disponibles :

AdaptyWebPresentation.InAppBrowser - Ouvre les liens dans un navigateur intégré à l’application (par défaut)
AdaptyWebPresentation.ExternalBrowser - Ouvre les liens dans le navigateur externe de l’appareil