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

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

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

Создайте два отдельных флоу — один для онбординга, другой для пейвола. Добавьте каждый в плейсмент. Код в этом рецепте получает флоу пейвола из плейсмента с 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 — функцию, которая открывает пейвол-флоу с графиком.

Когда пользователь нажимает кнопку с действием Close flow на последнем экране, слушатель открывает флоу пейвола вместо флоу онбординга.

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

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

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

5. Привяжите график к пользовательскому элементу

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

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

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

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

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

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

Чтобы протестировать фолбэк, верните из WeightChartResolver значение null и снова откройте пейвол-флоу.

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