Afficher la progression de l'utilisateur avec une animation Lottie

Suivez cette recette pour afficher la progression de l’utilisateur sous forme d’animation Lottie — par exemple, un anneau qui se remplit pour indiquer sa série quotidienne. Votre application affiche l’animation en tant que vue Lottie native dans un élément personnalisé.

Avant de commencer

Préparez une animation Lottie au format .json, ou téléchargez l’exemple streak_ring.json. L’application lit l’animation depuis le début et l’arrête proportionnellement à la progression, par exemple à mi-chemin pour 50 %. Pour afficher la progression exacte, l’animation doit respecter les conditions suivantes :

  • Aucune progression sur la première image, et une progression complète sur la dernière image.
  • Une vitesse constante, sans accélération ni décélération. Si l’animation démarre lentement puis accélère, elle affiche moins de la moitié de la progression à mi-chemin.

1. Ajouter l’élément personnalisé à l’écran

Dans le Flow & Paywall Builder, ajoutez un élément personnalisé à un écran de flow et configurez-le pour l’animation :

  • Type : lottie_animation.
  • ID : streak_ring. Dans cette recette, l’ID est aussi le nom du fichier d’animation.
  • Height : Conservez la hauteur Fixed par défaut. L’animation s’adapte à la taille de l’élément personnalisé.

À l’intérieur de l’élément personnalisé, ajoutez une Image avec une image fixe de l’anneau. Les utilisateurs la voient comme contenu de secours lorsque leur version de votre application ne prend pas en charge l’animation.

2. Ajoutez le fichier d’animation à votre application

Placez le fichier d’animation dans src/main/assets, le dossier assets de votre module d’application. Conservez-le à la racine de ce dossier, sans le placer dans un sous-dossier.

Le nom du fichier sans .json doit correspondre à l’ID de l’élément personnalisé, par exemple streak_ring.json pour streak_ring.

3. Créer la vue d’animation

Créez un modèle pour le streak et une vue qui joue l’animation. Votre application met à jour le modèle quand le streak change. La vue lit le modèle, donc l’anneau affiche le streak actuel à l’ouverture de l’écran :

4. Associer l’animation à l’élément personnalisé

Dans votre resolver global, ajoutez une propriété pour le modèle de série. Ensuite, retournez la vue d’animation pour le Type lottie_animation et l’ID streak_ring. Les lignes surlignées indiquent ce qu’il faut ajouter ou modifier. Si votre application n’a pas encore de resolver global, copiez l’intégralité du code :

Créez le resolver avec le modèle de streak, puis définissez-le comme resolver global de l’application. Appelez AdaptyUI.setCustomElementsResolver une seule fois, par exemple au lancement de l’application :

5. Tester sur un appareil

Le Flow & Paywall Builder ne peut pas exécuter le code de votre application, donc son canvas affiche uniquement le fallback. Pour prévisualiser l’animation :

  1. Publiez le flow. Pour voir la dernière version publiée plutôt qu’une version en cache, enregistrez l’appareil comme appareil de test.
  2. Lancez un build de votre application incluant le resolver. Définissez le streak à 0 jour, ouvrez l’écran et vérifiez que l’anneau reste vide. Recommencez avec 4 et 7 jours, et vérifiez que l’anneau se remplit jusqu’à chaque valeur.

Pour tester le fallback, supprimez le fichier d’animation du build, puis rouvrez l’écran.

Pour savoir pourquoi le paywall de secours s’affiche à la place de l’animation, suivez les instructions dans la section Tester sur un appareil du guide Android.