从PrimeTween迁移到LitMotion的技术指南

从PrimeTween迁移到LitMotion的技术指南

前言

LitMotion是一个轻量级、高性能的Unity动画库，相比PrimeTween提供了更简洁直观的API设计。本文将详细介绍如何将现有项目中的PrimeTween动画代码迁移到LitMotion，帮助开发者快速完成技术栈切换。

基础动画迁移

位置动画

在PrimeTween中，位置动画通常直接通过Tween.Position()方法实现。而LitMotion采用了更灵活的构建器模式：

// PrimeTween方式
Tween.Position(transform, endValue, duration);

// LitMotion方式
LMotion.Create(transform.position, endValue, duration)
    .BindToPosition(transform);

LitMotion的这种设计将动画创建和绑定分离，使得代码结构更清晰，也便于添加更多配置选项。

值动画

对于简单的值变化动画，两者的实现方式类似但语法略有不同：

// PrimeTween
float value = 0f;
Tween.Custom(value, endValue, duration, x => value = x);

// LitMotion
LMotion.Create(value, endValue, duration)
    .Bind(x => value = x);

特殊效果动画

冲击和震动效果

PrimeTween和LitMotion都提供了Punch(冲击)和Shake(震动)效果，但API设计有所不同：

// PrimeTween
Tween.ShakePosition(transform, ...);
Tween.PunchPosition(transform, ...);

// LitMotion
LMotion.Punch.Create(...)
    .BindToPosition(transform);
LMotion.Shake.Create(...)
    .BindToPosition(transform);

LitMotion将这些特殊效果单独封装，使代码意图更加明确。

动画配置

缓动曲线和循环

在动画配置方面，LitMotion采用了链式调用的方式：

// PrimeTween
Tween.Position(transform, endValue, duration, 
    ease: Ease.InOutSine, 
    cycle: 2, 
    cycleMode: CycleMode.Yoyo);

// LitMotion
LMotion.Create(transform.position, endValue, duration)
    .WithLoops(2, LoopType.Yoyo)
    .WithEase(Ease.OutQuad)
    .BindToPosition(transform);

这种设计使得每个配置选项都清晰可见，便于阅读和维护。

动画控制

播放控制

动画播放控制方面，两者概念相似但方法名不同：

// PrimeTween
tween.isPaused = true;
tween.Complete();
tween.Kill();

// LitMotion
handle.PlaybackSpeed = 0f; // 暂停
handle.Complate(); // 完成
handle.Cancel(); // 取消

动画序列

Sequence处理

动画序列的处理方式两者差异较大：

// PrimeTween
Sequence.Create()
    .Chain(...) 
    .Group(...)
    .Insert(...);

// LitMotion
LSequence.Create()
    .Append(...) // 顺序添加
    .Join(...)   // 并行添加
    .Insert(...) // 在指定时间插入
    .Run();

需要注意的是，LitMotion有意不提供Sequence回调功能，推荐使用async/await来实现复杂动画逻辑。

高级特性

更新时机控制

对于需要固定时间步长的动画：

// PrimeTween
Tween.PositionX(transform, 10f, new TweenSettings(duration: 1f, useFixedUpdate: true));

// LitMotion
LMotion.Create(transform.position.x, 10f, 1f)
    .WithScheduler(MotionScheduler.FixedUpdate)
    .BindToPositionX(transform);

Inspector支持

序列化动画配置：

// PrimeTween
[SerializeField] TweenSettings<float> settings;
Tween.PositionY(transform, settings);

// LitMotion
[SerializeField] SerializableMotionSettings<float, NoOptions> settings;
LMotion.Create(settings).BindToPositionY(transform);

协程和异步支持

// PrimeTween
yield return tween.ToYieldInstruction();
await tween;

// LitMotion
yield return handle.ToYieldInstruction();
await handle;

不兼容功能说明

延迟功能

LitMotion没有直接提供Tween.Delay()等效方法，这是设计上的取舍。

速度控制

Tween.**AtSpeed()功能在LitMotion中也不存在，开发者需要自行计算duration值。

总结

从PrimeTween迁移到LitMotion的过程相对简单，主要差异在于API设计理念的不同。LitMotion更强调代码的清晰性和灵活性，通过构建器模式提供了更直观的动画创建方式。对于特殊效果的实现，两者功能相似但API结构不同。开发者需要注意LitMotion有意省略的一些功能，如Sequence回调和延迟动画等，这些是设计上的取舍而非功能缺失。