Afficher les flows et paywalls - Flutter

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 comment il doit l’être.

Warning

Ce guide est destiné aux flows et paywalls rendus par Adapty. Pour présenter des paywalls personnalisés, consultez Présenter des paywalls personnalisés.

Le SDK Flutter d’Adapty propose deux façons de présenter des flows et des paywalls :

  • Écran autonome

  • Widget intégré

Présenter comme écran autonome

Pour afficher un flow ou un paywall comme écran autonome, utilisez la méthode view.present() sur le view créé par la méthode createFlowView. Par défaut, fermer un view le libère de la mémoire, vous ne pouvez donc pas le présenter à nouveau. Si vous avez besoin d’afficher le flow ou le paywall une nouvelle fois, appelez createFlowView une nouvelle fois pour créer une nouvelle instance de view, ou fermez-le sans le libérer avec le SDK 4.1 ou une version ultérieure.

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

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.

Fermer le flow ou le paywall

Quand vous avez besoin de fermer le flow ou le paywall par programmation, utilisez la méthode dismiss() :

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

Fermer une vue la libère de la mémoire — une vue fermée ne peut plus être réaffichée. Créez-en une nouvelle avec createFlowView à la place.

À partir du SDK 4.1, passez destroy: false pour conserver la vue en mémoire :

await view.dismiss(destroy: false);

Réaffichez cette vue et l’utilisateur retrouve l’écran qu’il avait quitté, avec l’état accumulé par le flow. Une vue conservée de cette façon reste en mémoire jusqu’à ce que vous la libériez.

À partir du SDK 4.3.0, lorsque vous n’avez plus besoin d’une vue conservée, libérez-la avec destroy() :

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

destroy() libère également une vue que vous avez créée mais jamais présentée, ainsi qu’une vue page-sheet que l’utilisateur a fermée en faisant 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 avec l’erreur wrongParam. Sur les versions antérieures du SDK, présentez à nouveau la vue conservée puis fermez-la avec destroy: true pour la libérer.

L’action de fermeture par défaut appelle view.dismiss(), ce qui libère la vue même si vous l’avez conservée avec destroy: false. Pour garder une vue quand l’utilisateur la ferme, surchargez flowViewDidPerformAction et effectuez vous-même la fermeture. Cette méthode s’exécute pour chaque flow et chaque paywall de votre application, donc comparez view.id pour ne conserver que la vue que vous comptez réafficher. Conservez le cas OpenUrlAction pour préserver l’ouverture des 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;
  }
}

Conservez la view que vous avez gardée : vous en aurez besoin pour présenter à nouveau le flow ou le paywall, et pour le libérer avec destroy(). 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 une vue paywall est affiché sur Android. Sur Android, les alertes classiques apparaissent derrière la vue, 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 ou du paywall sur toutes les plateformes.

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
}

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(). Le paramètre accepte les valeurs AdaptyUIIOSPresentationStyle.fullScreen (par défaut) ou AdaptyUIIOSPresentationStyle.pageSheet.

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

L’utilisateur peut glisser vers le bas pour fermer la page sheet. 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().

Intégrer dans la hiérarchie de widgets

Pour intégrer un flow ou un paywall dans votre arbre de widgets existant, utilisez directement le widget AdaptyUIFlowPlatformView dans votre hiérarchie de widgets 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

Pour que la vue de la plateforme Android fonctionne, assurez-vous que votre MainActivity étend FlutterFragmentActivity :

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

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. Un tel paywall contient à la fois ce qui doit être affiché et la manière dont cela doit l’être.

Warning

Ce guide couvre uniquement les paywalls créés dans l’ancien Paywall Builder pour Adapty SDK 3.x. Ils nécessitent SDK v3.2.0 ou une version ultérieure. La présentation d’un paywall créé pour SDK 2.x ou antérieur, ou d’un paywall personnalisé, fonctionne différemment.

Le SDK Adapty Flutter propose deux façons de présenter les paywalls :

  • Écran autonome

  • Widget intégré

Afficher comme écran autonome

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

Warning

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

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

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.

Fermer le paywall

Pour fermer le paywall par programmation, utilisez la méthode dismiss() :

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

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 de la boîte de dialogue au-dessus du paywall sur toutes les plateformes.

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
}

Configurer le style de présentation iOS

Configurez la façon dont le paywall est affiché 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.

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

Intégrer dans la hiérarchie de widgets

Pour intégrer un paywall dans votre arborescence de widgets existante, utilisez le widget AdaptyUIPaywallPlatformView directement dans votre hiérarchie de widgets 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

Pour que la vue de plateforme Android fonctionne, assurez-vous que votre MainActivity étend FlutterFragmentActivity :

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