Отображение прогресса пользователя с помощью Lottie-анимации

Следуйте этому рецепту, чтобы отобразить прогресс пользователя в виде Lottie-анимации — например, кольца, которое заполняется по мере накопления дневной серии. Приложение рендерит анимацию как нативный Lottie-вью в кастомном элементе.

Прежде чем начать

Подготовьте анимацию Lottie в формате .json или скачайте пример streak_ring.json. Приложение воспроизводит анимацию с начала и останавливает её пропорционально прогрессу: например, на середине при 50%. Чтобы корректно отобразить прогресс, анимация должна соответствовать следующим условиям:

  • На первом кадре прогресс равен нулю, на последнем — 100%.
  • Равномерная скорость без сглаживания. Если анимация начинается медленно и затем ускоряется, то на середине воспроизведения отобразится менее половины прогресса.

1. Добавьте пользовательский элемент на экран

В Flow & Paywall Builder добавьте пользовательский элемент на экран флоу и настройте его для анимации:

  • Type: lottie_animation.
  • ID: streak_ring. В этом рецепте ID также является именем файла анимации.
  • Height: Оставьте высоту Fixed по умолчанию. Анимация масштабируется, заполняя пользовательский элемент.

Внутри пользовательского элемента добавьте Image со статичным изображением кольца. Пользователи увидят его в качестве резервного контента, если версия вашего приложения не поддерживает воспроизведение анимации.

2. Добавьте файл анимации в приложение

Поместите файл анимации в src/main/assets — папку assets вашего модуля приложения. Файл должен находиться в корне этой папки, а не во вложенной директории.

Имя файла без .json должно совпадать с ID пользовательского элемента, например streak_ring.json для streak_ring.

3. Создайте анимированный экран

Создайте модель для серии и представление, воспроизводящее анимацию. Приложение обновляет модель при изменении серии. Представление считывает данные из модели, поэтому кольцо отображает текущую серию при открытии экрана:

4. Привяжите анимацию к кастомному элементу

В вашем общем резолвере добавьте свойство для модели streak. Затем верните анимационный view для типа lottie_animation и ID streak_ring. Выделенные строки показывают, что нужно добавить или изменить. Если в вашем приложении ещё нет общего резолвера, скопируйте весь код целиком:

Создайте резолвер с моделью серии и установите его как глобальный резолвер приложения. Вызовите AdaptyUI.setCustomElementsResolver один раз — например, при запуске приложения:

5. Протестируйте на устройстве

Flow & Paywall Builder не может выполнять код вашего приложения, поэтому на канвасе отображается только резервный вариант. Чтобы предварительно просмотреть анимацию:

  1. Опубликуйте флоу. Чтобы увидеть последнюю опубликованную версию вместо кэшированной, зарегистрируйте устройство как тестовое.
  2. Запустите сборку приложения с резолвером. Установите значение серии 0 дней, откройте экран и убедитесь, что кольцо остаётся пустым. Повторите с 4 и 7 днями и убедитесь, что кольцо заполняется до каждого значения.

Чтобы протестировать резервный вариант, удалите файл анимации из сборки и откройте экран снова.

Чтобы узнать, почему вместо анимации отображается резервный вариант, следуйте инструкциям в разделе Протестируйте на устройстве руководства для Android.