---
title: "Отображение прогресса пользователя с помощью Lottie-анимации"
description: "Отображайте прогресс каждого пользователя, например ежедневную серию, в виде Lottie-анимации на экране флоу."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

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

<DocVideo id="custom-element-lottie-demo.mp4" width="300px" alt="Готовый флоу: пользователь нажимает «See my streak», и на следующем экране кольцо заполняется до 4 из 7 дней." />

## Прежде чем начать \{#before-you-start\}

<Tabs groupId="current-os" queryString>
<TabItem value="kotlin" label="Kotlin" default>

- Обновите приложение до Adapty Android SDK 4.4 или выше. Более ранние версии SDK отображают [резервный контент](flow-custom-elements#set-fallback-content) для каждого кастомного элемента.
- Настройте приложение для [получения](android-get-pb-paywalls) и [отображения](android-present-paywalls) флоу.
- Настройте Jetpack Compose в модуле приложения. Анимационный виджет в этом рецепте является composable-компонентом.
- Добавьте Lottie для Jetpack Compose в приложение через Gradle из `com.airbnb.android:lottie-compose`.

</TabItem>
<TabItem value="java" label="Java">

- Обновите ваше приложение до Adapty Android SDK 4.4 или более поздней версии. Более ранние версии SDK показывают [резервный контент](flow-custom-elements#set-fallback-content) для каждого кастомного элемента.
- Настройте приложение для [получения](android-get-pb-paywalls) и [отображения](android-present-paywalls) флоу.
- Добавьте Lottie в ваше приложение через Gradle из `com.airbnb.android:lottie`.

</TabItem>
</Tabs>

Подготовьте анимацию Lottie в формате `.json` или скачайте пример [`streak_ring.json`](https://raw.githubusercontent.com/adaptyteam/adapty-docs/refs/heads/main/Downloads/streak_ring.json). Приложение воспроизводит анимацию с начала и останавливает её пропорционально прогрессу: например, на середине при 50%. Чтобы корректно отобразить прогресс, анимация должна соответствовать следующим условиям:

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

## 1. Добавьте пользовательский элемент на экран \{#1-add-the-custom-element-to-the-screen\}

В Flow & Paywall Builder [добавьте пользовательский элемент](flow-custom-elements#add-and-configure) на экран флоу и настройте его для анимации:

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

Внутри пользовательского элемента добавьте [**Image**](custom-media#image) со статичным изображением кольца. Пользователи увидят его в качестве [резервного контента](flow-custom-elements#set-fallback-content), если версия вашего приложения не поддерживает воспроизведение анимации.

## 2. Добавьте файл анимации в приложение \{#add-the-animation-file-to-your-app\}

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

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

## 3. Создайте анимированный экран \{#3-create-the-animation-view\}

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

<Tabs groupId="current-os" queryString>
<TabItem value="kotlin" label="Kotlin" default>

```kotlin showLineNumbers title="Kotlin"

// the streak that your app keeps up to date
class StreakStore {
    val currentStreak = MutableStateFlow(0) // days in a row
}

@Composable
fun StreakRing(animationFile: String, streakStore: StreakStore) {
    val composition by rememberLottieComposition(LottieCompositionSpec.Asset(animationFile))
    val streak by streakStore.currentStreak.collectAsState()

    // 7 days fill the ring: from 0 for an empty ring to 1 for a full one
    val progress = minOf(streak / 7f, 1f)

    LottieAnimation(
        composition = composition,
        modifier = Modifier.fillMaxSize(), // scale the animation to fit the custom element
        clipSpec = LottieClipSpec.Progress(0f, progress),
    )
}
```

`clipSpec = LottieClipSpec.Progress(0f, progress)` заполняет кольцо один раз — от пустого состояния до значения `progress`. Если в вашем приложении стрик уже хранится в `StateFlow`, используйте этот `StateFlow` вместо `StreakStore`.

</TabItem>
<TabItem value="java" label="Java">

```java showLineNumbers title="Java"

// the streak that your app keeps up to date
public class StreakStore {
    public final MutableLiveData<Integer> currentStreak = new MutableLiveData<>(0); // days in a row
}

public class StreakRingView extends LottieAnimationView {
    private final StreakStore streakStore;

    private final Observer<Integer> streakObserver = streak -> {
        // 7 days fill the ring: from 0 for an empty ring to 1 for a full one
        float progress = Math.min(streak / 7f, 1f);
        setMinAndMaxProgress(0f, progress);
        playAnimation();
    };

    public StreakRingView(Context context, String animationFile, StreakStore streakStore) {
        super(context);
        this.streakStore = streakStore;
        setAnimation(animationFile);
    }

    @Override
    protected void onAttachedToWindow() {
        super.onAttachedToWindow();
        streakStore.currentStreak.observeForever(streakObserver);
    }

    @Override
    protected void onDetachedFromWindow() {
        streakStore.currentStreak.removeObserver(streakObserver);
        super.onDetachedFromWindow();
    }
}
```

`setMinAndMaxProgress(0f, progress)` и `playAnimation()` заполняют кольцо один раз — от пустого до значения `progress`. Если в вашем приложении стрик уже хранится в `LiveData`, используйте эту `LiveData` вместо `StreakStore`.

</TabItem>
</Tabs>

## 4. Привяжите анимацию к кастомному элементу \{#match-the-animation-to-the-custom-element\}

В вашем [общем резолвере](android-flow-custom-elements#display-views-in-every-flow) добавьте свойство для модели streak. Затем верните анимационный view для типа `lottie_animation` и ID `streak_ring`. Выделенные строки показывают, что нужно добавить или изменить. Если в вашем приложении ещё нет общего [резолвера](android-flow-custom-elements#write-a-resolver-to-match-custom-elements-and-views), скопируйте весь код целиком:

<Tabs groupId="current-os" queryString>
<TabItem value="kotlin" label="Kotlin" default>

```kotlin showLineNumbers title="Kotlin" {8,22-28}

class CustomElementsResolver(
    context: Context,
    private val streakStore: StreakStore,
) : AdaptyCustomElementsResolver {
    // the animation files in the assets folder, listed once
    private val animationFiles: Set<String> = try {
        context.assets.list("").orEmpty().toSet()
    } catch (e: IOException) {
        emptySet() // no list of files: every Lottie element shows the fallback
    }

    override fun resolve(type: String, id: String): AdaptyCustomElementContent? =
        when (type) {
            "lottie_animation" -> {
                // the ID names the animation file, such as streak_ring.json
                val file = "$id.json"
                when {
                    file !in animationFiles -> null // no file for this ID: show the fallback
                    id == "streak_ring" ->
                        AdaptyCustomElementContent.compose { StreakRing(file, streakStore) }
                    // the other animations of your resolver
                    else -> null
                }
            }
            // the other Types of your resolver
            else -> null
        }
}
```

Если в папке `assets` нет файла с нужным ID, резолвер возвращает `null`, и пользователи видят фолбэк. Если ваш резолвер уже возвращает [вью для каждого файла анимации](android-flow-custom-elements#write-a-resolver-to-match-custom-elements-and-views), верните это вью вместо `null`, когда ID не равен `streak_ring`. Так пользователи по-прежнему будут видеть анимации остальных кастомных элементов `lottie_animation`.

</TabItem>
<TabItem value="java" label="Java">

```java showLineNumbers title="Java" {10,14-15,34-40}

public class CustomElementsResolver implements AdaptyCustomElementsResolver {
    private final StreakStore streakStore;
    // the animation files in the assets folder, listed once
    private final Set<String> animationFiles = new HashSet<>();

    public CustomElementsResolver(Context context, StreakStore streakStore) {
        this.streakStore = streakStore;
        try {
            String[] files = context.getAssets().list("");
            if (files != null) {
                animationFiles.addAll(Arrays.asList(files));
            }
        } catch (IOException e) {
            // no list of files: every Lottie element shows the fallback
        }
    }

    @Override
    public AdaptyCustomElementContent resolve(String type, String id) {
        if (type.equals("lottie_animation")) {
            // the ID names the animation file, such as streak_ring.json
            String file = id + ".json";
            if (!animationFiles.contains(file)) {
                return null; // no file for this ID: show the fallback
            }
            if (id.equals("streak_ring")) {
                return AdaptyCustomElementContent.view(
                        (context, elementContext) -> new StreakRingView(context, file, streakStore)
                );
            }
            // the other animations of your resolver
            return null;
        }
        // the other Types of your resolver
        return null;
    }
}
```

Если в папке `assets` нет файла с нужным ID, резолвер возвращает `null` и пользователь видит фолбэк. Если ваш резолвер уже возвращает [вью для каждого файла анимации](android-flow-custom-elements#write-a-resolver-to-match-custom-elements-and-views), возвращайте это вью вместо `null`, когда ID не совпадает с `streak_ring`. Так анимации остальных кастомных элементов `lottie_animation` по-прежнему будут работать.

</TabItem>
</Tabs>

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

<Tabs groupId="current-os" queryString>
<TabItem value="kotlin" label="Kotlin" default>

```kotlin showLineNumbers title="Kotlin"

class App : Application() {
    // the streak model that your app updates
    val streakStore = StreakStore()

    // keep this instance: a resolver for one flow can reuse it
    // lazy: the context isn't attached yet while App is constructed
    val customElementsResolver by lazy { CustomElementsResolver(this, streakStore) }

    override fun onCreate() {
        super.onCreate()
        AdaptyUI.setCustomElementsResolver(customElementsResolver)
    }
}
```

</TabItem>
<TabItem value="java" label="Java">

```java showLineNumbers title="Java"

public class App extends Application {
    // the streak model that your app updates
    private final StreakStore streakStore = new StreakStore();
    // keep this instance: a resolver for one flow can reuse it
    private CustomElementsResolver customElementsResolver;

    @Override
    public void onCreate() {
        super.onCreate();
        customElementsResolver = new CustomElementsResolver(this, streakStore);
        AdaptyUI.setCustomElementsResolver(customElementsResolver);
    }

    public StreakStore getStreakStore() {
        return streakStore;
    }

    public CustomElementsResolver getCustomElementsResolver() {
        return customElementsResolver;
    }
}
```

</TabItem>
</Tabs>

## 5. Протестируйте на устройстве \{#test-on-a-device\}

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

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

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

Чтобы узнать, почему вместо анимации отображается резервный вариант, следуйте инструкциям в разделе [Протестируйте на устройстве](android-flow-custom-elements#test-on-a-device) руководства для Android.