Показать интерактивный график цели по весу в пейволе

Следуйте этому рецепту, чтобы отображать прогнозируемый вес пользователя в виде графика в флоу пейвола. Пользователь вводит текущий и целевой вес в онбординговом флоу. Ваше приложение собирает оба значения. График показывает еженедельный прогресс, которого пользователь может ожидать с вашим приложением, — от одного значения к другому. Приложение отображает график как нативный Swift Charts view в кастомном элементе.

Tip

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

Перед началом работы

  • Обновите приложение до Adapty iOS SDK 4.4 или выше. Более ранние версии SDK показывают резервный контент для каждого кастомного элемента.
  • Настройте приложение для получения и отображения флоу.
  • Создайте два отдельных флоу — один для онбординга, другой для пейвола. Добавьте каждый в плейсмент. Код в этом рецепте получает флоу пейвола из плейсмента с ID weight_paywall.

1. Запросите текущий и целевой вес в онбординге

В Flow & Paywall Builder добавьте два поля Number в онбординг-флоу:

  • Одно для текущего веса в килограммах с Element ID weight.
  • Одно для целевого веса в килограммах с Element ID goal_weight.

Чтобы ваше приложение одинаково считывало веса во всех локалях, выберите Integer в выпадающем списке Format для обоих полей ввода. Поле ввода отправляет значение в приложение в виде текста, точно в том виде, как его напечатал пользователь. Код из этого рецепта по-разному обрабатывает «70.5» и «70,5». Целые числа не имеют десятичного разделителя.

Чтобы приложение гарантированно получило оба значения, завершите флоу онбординга экраном без полей ввода. На этом экране добавьте кнопку с действием Close flow. Поля ввода отправляют свои значения, когда теряют фокус или когда пользователь переходит на другой экран.

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

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

  • Type: line_chart.
  • ID: weight_goal.
  • Height: Оставьте высоту Fixed по умолчанию. График заполнит пользовательский элемент.

Не помещайте пользовательский элемент в контейнеры, реагирующие на касание, например в карусель. Иначе перетаскивание по графику будет также перемещать карусель.

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

3. Сохраните текущий и целевой вес в приложении

Собирайте текущий и целевой вес из событий flow_user_input онбординг-флоу, как описано в разделе Обработка данных из флоу. Чтобы определить, что пользователь достиг последнего экрана, отслеживайте событие flow_screen_showed с is_last_screen равным true. Когда онбординг-флоу закрывается после этого экрана, передайте оба значения веса в метод showWeightPaywall, который открывает пейвол-флоу с графиком.

Следующий код предназначен для UIKit. Один контроллер представления является делегатом обоих флоу. Он также должен реализовывать методы покупки и восстановления протокола AdaptyFlowControllerDelegate. В этом примере они опущены. Чтобы их увидеть, перейдите к разделу Отображение флоу и пейволов в UIKit.

В SwiftUI используйте замыкания didReceiveAnalyticEvent и didDisappear модификатора .flow вместо методов делегата. Отображайте флоу пейвола с помощью второго модификатора .flow.

4. Создайте представление графика

Создайте модель плана похудения и SwiftUI-представление с графиком. В плане одна запись на неделю — от текущего веса до целевого. Когда пользователь проводит пальцем по графику, представление отмечает неделю в точке касания и показывает прогнозируемый вес для этой недели:

В плане предполагается, что вес меняется на 0,5 кг в неделю. Чтобы изменить темп, отредактируйте weeklyChange.

Перетаскивание по графику требует iOS 17 или новее. На iOS 16 пользователи видят линию, но не могут перетаскивать по ней.

5. Сопоставьте график с кастомным элементом

Напишите resolver, который возвращает вью с графиком для типа line_chart и ID weight_goal. Сохраните план веса как свойство resolver-а:

Прикрепите resolver к флоу пейвола при получении его конфигурации. Создайте resolver с планом веса на основе текущего и целевого веса:

Если в вашем приложении задан общий resolver для всего приложения, этот resolver заменяет его во флоу пейвола. WeightChartResolver возвращает nil для любых других Type и ID, поскольку флоу пейвола в данном рецепте не содержит других кастомных элементов. Если в вашем флоу пейвола есть другие кастомные элементы, передайте общий resolver в этот. Затем вызывайте общий resolver для их Types и IDs, как описано в разделе Привязать resolver к одному флоу.

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

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

  1. Опубликуйте оба флоу. Чтобы видеть последние опубликованные версии вместо закэшированных, зарегистрируйте устройство как тестовое.
  2. Запустите сборку приложения с резолвером на iOS 17 или новее. Пройдите флоу онбординга, указав текущий и целевой вес. Убедитесь, что линия графика начинается с текущего веса и заканчивается на целевом.
  3. Проведите пальцем по графику и убедитесь, что прогнозируемый вес для недели под пальцем отображается над линией.

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

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