Afficher les flows et paywalls - Unity
Si vous avez créé un flow ou un paywall dans l’ancien Paywall Builder, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Un tel flow ou paywall contient à la fois ce qui doit être affiché et la façon dont cela doit l’être.
Ce guide concerne les flows et les paywalls rendus par Adapty. Le processus est différent pour les paywalls personnalisés et le mode Observer.
- Pour présenter des paywalls personnalisés, consultez Présenter des paywalls personnalisés.
- Pour présenter des flows en Observer mode, consultez Présenter des flows en Observer mode.
Pour obtenir l’objet view utilisé ci-dessous, consultez Obtenir des flows et paywalls.
Pour afficher un flow ou un paywall, utilisez la méthode view.Present() sur le view créé par la méthode CreateFlowView. Par défaut, un view fermé est détruit. Pour afficher le flow à nouveau, appelez CreateFlowView une nouvelle fois pour créer une nouvelle instance de view, ou conservez le view au moment de le fermer.
Réutiliser un view détruit entraîne une erreur.
view.Present((error) => {
// handle the error
});Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Découvrez nos applications exemples, qui illustrent la configuration complète, notamment l’affichage des paywalls, la réalisation d’achats et d’autres fonctionnalités de base.
Conserver la vue pour la réafficher
Les vues conservées sont disponibles à partir de la version 4.3.0 du SDK.
view.Dismiss() libère la vue de la mémoire. Pour conserver la vue à la place, passez false comme paramètre destroy :
view.Dismiss(false, (error) => {
// handle the error
});Réaffichez cette vue et l’utilisateur retrouve l’écran où il s’était arrêté, dans l’état que le flow avait atteint. La vue conserve son Id, donc ses événements continuent d’arriver dans votre listener avec le même view.Id.
Une vue conservée reste en mémoire jusqu’à ce que vous la libériez. Lorsque vous n’en avez plus besoin, appelez view.Destroy() :
view.Destroy((error) => {
// handle the error
});Destroy() ferme d’abord la vue si elle est encore à l’écran. Cette méthode libère également une vue que vous avez créée mais jamais affichée, ainsi qu’une vue en feuille de page que l’utilisateur a fait glisser vers le bas sur iOS. N’appelez pas cette méthode après un Dismiss() classique : cette vue est déjà libérée, et l’appel échoue.
Pour conserver une vue lorsque l’utilisateur appuie sur le bouton Close, rejetez-la avec destroy: false dans votre gestionnaire d’action Close. La méthode FlowViewDidPerformAction s’exécute pour chaque flow et paywall de votre application, pensez donc à comparer view.Id pour ne conserver que la vue que vous prévoyez d’afficher à nouveau. Stockez la vue dans un champ au moment de sa création, afin de pouvoir la comparer et la réafficher ultérieurement :
private AdaptyUIFlowView keptView;
void CreateKeptView(AdaptyFlow flow) {
AdaptyUI.CreateFlowView(flow, new AdaptyUICreateFlowViewParameters(), (view, error) => {
if (error != null) {
// handle the error
return;
}
keptView = view;
});
}
public void FlowViewDidPerformAction(
AdaptyUIFlowView view,
AdaptyUIUserAction action
) {
switch (action.Type) {
case AdaptyUIUserActionType.Close:
view.Dismiss(view.Id != keptView?.Id, null);
break;
default:
// handle other events
break;
}
}Conservez la view récupérée : vous en aurez besoin pour présenter à nouveau le flow ou le paywall, et pour la libérer avec Destroy(). Après avoir appelé keptView.Destroy(), mettez keptView à null, afin que la comparaison ci-dessus ne corresponde pas à une vue libérée. Tout autre appel à view.Dismiss() libère également la vue, y compris l’appel dans FlowViewDidReceiveError. Après une erreur de vue, créez une nouvelle vue avec CreateFlowView.
Afficher une boîte de dialogue
Utilisez cette méthode à la place des boîtes de dialogue d’alerte natives lorsqu’un flow ou un paywall est affiché sur Android. Sur Android, les alertes classiques apparaissent derrière la vue du flow, ce qui les rend invisibles pour les utilisateurs. Cette méthode garantit un affichage correct de la boîte de dialogue au-dessus du flow sur toutes les plateformes.
var dialog = new AdaptyUIDialogConfiguration()
.SetTitle("Close this screen?")
.SetContent("You will lose access to exclusive offers.")
.SetDefaultActionTitle("Stay")
.SetSecondaryActionTitle("Close");
AdaptyUI.ShowDialog(view, dialog, (action, error) => {
if (error == null) {
if (action == AdaptyUIDialogActionType.Secondary) {
// User confirmed - close the flow
view.Dismiss((error) => {
// handle the error
});
}
// If primary - do nothing, user stays
}
});Configurer le style de présentation iOS
Configurez la façon dont le flow ou le paywall est présenté sur iOS en passant le paramètre iosPresentationStyle à la méthode Present(). Ce paramètre accepte les valeurs AdaptyUIIOSPresentationStyle.FullScreen (par défaut) ou AdaptyUIIOSPresentationStyle.PageSheet.
view.Present(AdaptyUIIOSPresentationStyle.PageSheet, (error) => {
// handle the error
});L’utilisateur peut faire glisser la feuille de page vers le bas pour la fermer. La vue reste alors en mémoire sans appel à Dismiss() : présentez-la à nouveau, ou, à partir du SDK 4.3.0, libérez-la avec Destroy().
Si vous avez personnalisé un paywall avec le Paywall Builder, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Ce type de paywall contient à la fois ce qui doit être affiché et la façon dont cela doit l’être.
Ce guide concerne l’ancien Paywall Builder, qui nécessite le SDK Adapty 3.3.0 ou une version ultérieure.
Pour présenter des paywalls personnalisés, consultez Présenter des paywalls personnalisés.
Pour afficher un paywall, utilisez la méthode view.Present() sur la view créée par la méthode CreatePaywallView. Chaque view ne peut être utilisée qu’une seule fois. Si vous devez afficher le paywall à nouveau, appelez CreatePaywallView 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((error) => {
// handle the error
});Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Découvrez nos applications exemples, qui illustrent la configuration complète, notamment l’affichage des paywalls, la réalisation d’achats et d’autres fonctionnalités de base.
Afficher une boîte de dialogue
Utilisez cette méthode à la place des boîtes de dialogue d’alerte natives lorsqu’une vue de paywall est affichée sur Android. Sur Android, les alertes classiques apparaissent derrière la vue du paywall, ce qui les rend invisibles pour les utilisateurs. Cette méthode garantit un affichage correct des boîtes de dialogue au-dessus du paywall sur toutes les plateformes.
var dialog = new AdaptyUIDialogConfiguration()
.SetTitle("Close paywall?")
.SetContent("You will lose access to exclusive offers.")
.SetDefaultActionTitle("Stay")
.SetSecondaryActionTitle("Close");
AdaptyUI.ShowDialog(view, dialog, (action, error) => {
if (error == null) {
if (action == AdaptyUIDialogActionType.Secondary) {
// User confirmed - close the paywall
view.Dismiss();
}
// If primary - do nothing, user stays
}
});Configurer le style de présentation iOS
Configurez la façon dont le paywall est présenté sur iOS en passant le paramètre iosPresentationStyle à la méthode Present(). Ce paramètre accepte les valeurs AdaptyUIIOSPresentationStyle.FullScreen (par défaut) ou AdaptyUIIOSPresentationStyle.PageSheet.
view.Present(AdaptyUIIOSPresentationStyle.PageSheet, (error) => {
// handle the error
});