Показать интерактивный график цели по весу в пейволе
Следуйте этому рецепту, чтобы отображать прогнозируемый вес пользователя в виде графика в флоу пейвола. Пользователь вводит текущий и целевой вес в онбординговом флоу. Ваше приложение собирает оба значения. График показывает еженедельный прогресс, которого пользователь может ожидать с вашим приложением, — от одного значения к другому. Приложение отображает график как нативный Swift Charts view в кастомном элементе.
Этот рецепт распространяется только на 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 не может выполнять код вашего приложения, поэтому на холсте отображается только резервный вариант. Чтобы посмотреть график:
- Опубликуйте оба флоу. Чтобы видеть последние опубликованные версии вместо закэшированных, зарегистрируйте устройство как тестовое.
- Запустите сборку приложения с резолвером на iOS 17 или новее. Пройдите флоу онбординга, указав текущий и целевой вес. Убедитесь, что линия графика начинается с текущего веса и заканчивается на целевом.
- Проведите пальцем по графику и убедитесь, что прогнозируемый вес для недели под пальцем отображается над линией.
Чтобы протестировать резервный вариант, удалите аргумент customElementsResolver из вызова getFlowConfiguration и снова откройте флоу пейвола.
Чтобы разобраться, почему вместо графика отображается резервный вариант, следуйте инструкциям из раздела Тест на устройстве в руководстве для iOS.