在付费墙中展示互动式体重目标图表

按照此方案,在付费墙流程中以数据图表形式展示每位用户的预计体重变化。用户在用户引导流程中输入当前体重和目标体重,你的应用收集这两个值。数据图表展示用户在你的应用帮助下每周可实现的进度,从初始值到目标值。你的应用将该数据图表作为原生视图渲染在自定义元素中,无需借助图表库即可绘制。

开始之前

创建两个独立的流程——一个用于用户引导,一个用于付费墙。将每个流程添加到对应的版位。本示例代码从 ID 为 weight_paywall 的版位获取付费墙流程。

1. 在用户引导流程中询问当前体重和目标体重

在流程与付费墙编辑工具中,向用户引导流程添加两个 Number 输入框:

  • 一个用于输入当前体重(千克),Element ID 设为 weight。
  • 一个用于输入目标体重(千克),Element ID 设为 goal_weight。

为确保您的应用在所有语言环境下以统一方式读取体重值,请在两个输入框的 Format 下拉菜单中选择 Integer。输入框会将用户输入的内容原样以文本形式发送给应用。本示例代码对 “70.5” 和 “70,5” 的处理方式不同,而整数没有小数分隔符。

为确保应用能接收到两个值,请在用户引导流程的末尾添加一个不包含任何输入框的屏幕。在该屏幕上添加一个按钮,并为其配置 Close flow 操作。输入框会在失去焦点或用户切换到另一个屏幕时发送其值。

2. 将自定义元素添加到付费墙页面

在付费墙流程中,向某个屏幕添加自定义元素,并为数据图表进行配置:

  • Type:line_chart。
  • ID:weight_goal。
  • Height:保持默认的 Fixed 高度。图表将填满整个自定义元素。

请将自定义元素放在不响应触摸的容器之外(如轮播图),以确保只有图表响应拖动操作。

在自定义元素内部,添加一个包含示例体重图表的Image。当用户所使用的 app 版本无法显示图表时,该图片将作为备用内容展示。

3. 在应用中保存当前体重和目标体重

从用户引导流程的 flow_user_input 事件中获取当前体重和目标体重,具体方式参见处理流程数据。若要判断用户是否已到达最后一个屏幕,可监听 flow_screen_showed 事件中 is_last_screen 是否为 true。当用户引导流程在该屏幕关闭后,将两个体重值传入 showWeightPaywall——即打开带数据图表的付费墙流程的函数。

当用户在最后一个页面点击带有 关闭流程 操作 的按钮时,监听器会用付费墙流程替换用户引导流程。

4. 创建数据图表视图

创建体重计划的数据模型和包含数据图表的视图。该计划按周记录数据,从当前体重到目标体重。当用户在数据图表上拖动时,视图会标记触摸点对应的周次,并显示该周的预测体重:

该方案假设每周体重变化为 0.5 kg。如需使用其他变化速率,请修改 weeklyChange。

5. 将数据图表与自定义元素关联

编写一个解析器,使其为 line_chart 类型和 weight_goal ID 返回图表视图。将体重计划存储在解析器的属性中:

创建付费墙流程视图时,附加解析器。使用当前体重和目标体重的减重计划创建解析器:

如果你的应用设置了全局解析器,该解析器会在付费墙流程中被此解析器替换。WeightChartResolver 对其他任何 Type 和 ID 均不返回视图,因为此示例中的付费墙流程没有其他自定义元素。如果你的付费墙流程包含其他自定义元素,请将全局解析器传入此解析器,然后针对对应的 Type 和 ID 调用全局解析器,具体方式参见为单个流程显示数据。

6. 在设备上测试

流程与付费墙编辑工具无法运行你的应用代码,因此其画布只显示备用内容。要预览数据图表:

  1. 发布两个流程。若要查看最新发布版本而非缓存版本,请将设备注册为测试设备。
  2. 运行包含解析器的应用构建版本。完成用户引导流程,输入当前体重和目标体重。验证数据图表的折线是否从当前体重开始,到目标体重结束。
  3. 在数据图表上拖动,验证手指所在周的预估体重是否显示在折线上方。

如需测试备用付费墙,请让 WeightChartResolver 返回 null,然后重新打开付费墙流程。

要了解为什么出现备用付费墙而非数据图表,请按照 Android 指南中在设备上测试部分的说明操作。