Mostrar el progreso del usuario con una animación Lottie

Sigue esta guía para mostrar el progreso del usuario como una animación Lottie — por ejemplo, un anillo que se rellena para indicar su racha diaria. Tu app renderiza la animación como una vista Lottie nativa en un elemento personalizado.

Antes de empezar

Prepara una animación Lottie en formato .json, o descarga el ejemplo streak_ring.json. La app reproduce la animación desde el principio y la detiene en proporción al progreso; por ejemplo, a la mitad para un 50%. Para mostrar el progreso exacto, la animación necesita:

  • Ningún progreso en su primer fotograma y progreso completo en el último.
  • Una velocidad constante, sin aceleración ni desaceleración. Si la animación empieza despacio y luego acelera, mostrará menos de la mitad del progreso cuando llegue al punto intermedio.

1. Añade el elemento personalizado a la pantalla

En el Flow & Paywall Builder, añade un elemento personalizado a una pantalla del flow y configúralo para la animación:

  • Type: lottie_animation.
  • ID: streak_ring. En esta receta, el ID es también el nombre del archivo de animación.
  • Height: Mantén la altura Fixed predeterminada. La animación se escala para ajustarse al elemento personalizado.

Dentro del elemento personalizado, añade una Image con una imagen estática del anillo. Los usuarios la verán como fallback cuando la versión de tu app no reproduzca la animación.

2. Añade el archivo de animación a tu app

Coloca el archivo de animación en src/main/assets, la carpeta assets de tu módulo de app. Mantenlo en la raíz de esa carpeta, sin subcarpetas.

El nombre del archivo sin .json debe coincidir con el ID del elemento personalizado; por ejemplo, streak_ring.json para streak_ring.

3. Crea la vista de animación

Crea un modelo para la racha y una vista que reproduzca la animación. Tu app actualiza el modelo cuando cambia la racha. La vista lee el modelo, por lo que el anillo muestra la racha actual cuando se abre la pantalla:

4. Asocia la animación con el elemento personalizado

En tu resolver global, añade una propiedad para el modelo de racha. Luego devuelve la vista de animación para el tipo lottie_animation y el ID streak_ring. Las líneas resaltadas muestran qué añadir o cambiar. Si tu app aún no tiene un resolver global, copia el código completo:

Crea el resolver con el modelo de racha y configúralo como resolver global de la app. Llama a AdaptyUI.setCustomElementsResolver una sola vez, por ejemplo al arrancar la app:

5. Prueba en un dispositivo

El Flow & Paywall Builder no puede ejecutar el código de tu app, por lo que el canvas solo muestra el respaldo. Para previsualizar la animación:

  1. Publica el flow. Para ver la última versión publicada en lugar de una versión en caché, registra el dispositivo como dispositivo de prueba.
  2. Ejecuta una compilación de tu app que incluya el resolver. Establece el streak en 0 días, abre la pantalla y verifica que el anillo permanezca vacío. Repite con 4 y 7 días, y verifica que el anillo se llene hasta cada valor.

Para probar el respaldo, elimina el archivo de animación de la compilación y abre la pantalla de nuevo.

Para descubrir por qué aparece el respaldo en lugar de la animación, sigue las instrucciones de la sección Prueba en un dispositivo de la guía de Android.