Présenter les onboardings dans le SDK Unity

Warning

Les onboardings sont dépréciés à partir du SDK Adapty v4. Créez des flows à la place : contrairement aux onboardings, qui s’exécutent dans une WebView, les flows s’affichent nativement sur l’appareil — animations plus fluides, aspect natif cohérent, temps de chargement réduits et aucune dépendance à l’environnement WebView.

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

Avant de commencer, assurez-vous que :

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

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

Warning

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
});
Important

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