Lottie-iOS 中 dotLottie 动画循环模式问题解析

问题现象

在使用 Lottie-iOS 框架时，开发者发现通过 LottieAnimationView(dotLottieName:) 初始化 dotLottie 格式动画后，设置 loopMode = .loop 无法使动画循环播放。动画仅播放一次即停止，不符合预期行为。

技术背景

Lottie 是 Airbnb 开源的动画渲染库，支持通过 JSON 格式描述矢量动画。dotLottie 是 Lottie 的一种打包格式，可以包含多个动画资源及其元数据。

问题原因分析

经过技术团队确认，这是 dotLottie 动画的预期行为。因为 dotLottie 文件中的 manifest 包含了动画的循环模式配置，当加载动画时，这些配置会覆盖代码中设置的 loopMode 属性。

解决方案

目前有两种可行的解决方案：

1. 在动画加载完成后修改循环模式
   在 animationLoaded 回调中重新设置 loopMode = .loop，这会覆盖 dotLottie 文件中指定的循环模式配置。

   animationView.animationLoaded = { [weak self] _ in
       self?.animationView.loopMode = .loop
       self?.animationView.play()
   }
   

2. 等待 SwiftUI LottieView 的更新
   技术团队已经在 SwiftUI 的 LottieView 中进行了改进，默认不再应用 dotLottie 的循环模式，而是让开发者自行选择是否采用。

最佳实践建议

对于需要精确控制动画行为的场景，建议：

1. 明确了解 dotLottie 文件中包含的动画配置
2. 在适当的生命周期阶段（如动画加载完成后）设置所需的播放参数
3. 对于关键动画效果，考虑使用标准 Lottie JSON 格式以获得更直接的控制

总结

这个问题揭示了 dotLottie 格式与标准 Lottie JSON 在行为上的一些差异。理解这种差异有助于开发者更好地利用 Lottie-iOS 框架实现所需的动画效果。随着框架的更新，未来可能会有更灵活的控制方式出现。

对于设计师而言，需要注意 dotLottie 文件中可以包含动画的播放配置，这些配置会影响最终在应用程序中的表现。开发团队和设计团队需要就这些细节进行充分沟通，以确保动画效果符合产品预期。