通过 Lottie 动画展示用户进度

按照此方案,将用户进度以 Lottie 动画的形式展示——例如,用一个逐渐填充的圆环来表示用户的每日连续打卡天数。你的应用会在自定义元素中以原生 Lottie 视图渲染该动画。

开始前的准备

准备一个 .json 格式的 Lottie 动画,或下载示例文件 streak_ring.json。应用会从头播放动画,并按进度比例停止,例如进度为 50% 时停在中间位置。为了准确呈现进度,动画需要满足以下要求:

  • 第一帧不显示任何进度,最后一帧显示完整进度。
  • 匀速播放,不带缓动效果。如果动画开始时较慢、后来加速,则播放到一半时显示的进度会少于 50%。

1. 将自定义元素添加到屏幕

在流程与付费墙编辑工具中,向流程屏幕添加自定义元素,并为动画进行如下配置:

  • 类型:lottie_animation。
  • ID:streak_ring。在本示例中,ID 同时也是动画文件的名称。
  • 高度:保持默认的固定高度。动画会自动缩放以适应自定义元素的尺寸。

在自定义元素内部,添加一个包含圆环静态图片的图片。当用户使用的应用版本不支持播放动画时,该图片将作为备用内容显示。

2. 将动画文件添加到应用

将动画文件放入 src/main/assets,即应用模块的 assets 文件夹。请将其放在该文件夹的根目录下,不要放在子文件夹中。

文件名(不含 .json 扩展名)必须与自定义元素的 ID 一致,例如 streak_ring 对应 streak_ring.json。

3. 创建动画视图

创建连续打卡的数据模型,以及播放动画的视图。当连续打卡数变化时,你的应用更新该模型。视图读取模型数据,因此当页面打开时,圆环会显示当前的连续打卡数:

4. 将动画与自定义元素关联

在你的全局 resolver 中,为 streak 模型添加一个属性。然后为 lottie_animation 类型和 streak_ring ID 返回动画视图。高亮行表示需要添加或修改的内容。如果你的应用还没有全局 resolver,可以直接复制完整代码:

创建包含打卡模型的解析器,并将其设置为全局解析器。在应用启动时调用一次 AdaptyUI.setCustomElementsResolver:

5. 在设备上测试

流程与付费墙编辑工具无法运行您的应用代码,因此画布上只显示备用内容。如需预览动画:

  1. 发布流程。若要查看最新发布版本而非缓存版本,请将设备注册为测试设备。
  2. 运行包含 resolver 的应用构建版本。将连续天数设为 0 天,打开界面,验证圆环保持空心状态。分别设为 4 天和 7 天后重复操作,验证圆环是否填充至对应值。

如需测试备用内容,请从构建版本中移除动画文件,然后再次打开界面。

要了解为什么显示的是备用内容而不是动画,请参照 Android 指南中在设备上测试部分的说明。