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

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

Tip

Этот рецепт распространяется только на iOS-приложения. Приложения, созданные на других фреймворках, отображают только резервный контент кастомных элементов. Поддержка Android и кросс-платформенных фреймворков появится позже.

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

  • Обновите приложение до Adapty iOS SDK 4.4 или новее. Более ранние версии SDK показывают резервный контент для каждого кастомного элемента.
  • Настройте приложение для получения и отображения флоу.
  • Добавьте Lottie в приложение через Swift Package Manager по адресу https://github.com/airbnb/lottie-spm.git.
  • Подготовьте анимацию Lottie в формате .json или скачайте пример streak_ring.json. Приложение воспроизводит анимацию с начала и останавливает её пропорционально прогрессу — например, на середине при 50%. Чтобы прогресс отображался точно, анимация должна соответствовать следующим требованиям:
    • На первом кадре прогресс равен нулю, на последнем — полный прогресс.
    • Постоянная скорость без ускорений и замедлений. Если анимация начинается медленно и затем ускоряется, то на середине воспроизведения будет показано меньше половины прогресса.

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

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

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

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

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

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

3. Создайте анимированное представление

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

.playing(.fromProgress(0, toProgress: progress, loopMode: .playOnce)) заполняет кольцо один раз — от пустого состояния до значения progress. Если в вашем приложении стрик уже хранится в ObservableObject, используйте этот объект вместо StreakStore.

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

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

Поместите case streak_ring перед другими case lottie_animation, потому что Swift выполняет только первый подходящий case. Если в бандле приложения нет файла с таким ID, резолвер возвращает nil, и пользователи видят фолбэк.

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

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

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

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

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

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