LitMotion 使用教程

LitMotion 使用教程

LitMotion Lightning-fast and Zero Allocation Tween Library for Unity. 项目地址: https://gitcode.com/gh_mirrors/li/LitMotion

1. 项目介绍

LitMotion 是一个专为 Unity 设计的高性能补间动画库（tweening library）。它支持对 Transform、Material、TextMeshPro 等组件以及任何字段或属性的动画制作，使得创建动画变得极为简单。LitMotion 在创建和更新补间动画时表现出色，速度是其他库的 2 到 20 倍，且在创建补间时无需分配内存。

2. 项目快速启动

首先，确保你的 Unity 项目已经安装了以下依赖项：

• Unity 2021.3 或更高版本
• Burst 1.6.0 或更高版本
• Collection 1.5.1 或更高版本
• Mathematics 1.0.0 或更高版本

然后，通过以下步骤将 LitMotion 添加到你的 Unity 项目中：

# 打开 Package Manager 从 Window > Package Manager
# 点击 "+" 按钮并选择 "Add package from git URL"
# 输入以下 URL：
https://github.com/AnnulusGames/LitMotion.git?path=src/LitMotion/Assets/LitMotion

或者，你也可以手动添加依赖项：

// 打开 Packages/manifest.json 并在 dependencies 块中添加以下内容：
{
  "dependencies": {
    "com.annulusgames.lit-motion": "https://github.com/AnnulusGames/LitMotion.git?path=src/LitMotion/Assets/LitMotion"
  }
}

以下是一个简单的示例，展示了如何使用 LitMotion 创建动画：

using UnityEngine;
using LitMotion;

public class Example : MonoBehaviour
{
    [SerializeField] Transform target;

    void Start()
    {
        LMotion.Create(target.position, new Vector3(1, 1, 1), 2f)
            .BindToPosition(target)
            .WithEase(Ease.OutQuad)
            .WithLoops(2, LoopType.Yoyo)
            .Start();
    }
}

3. 应用案例和最佳实践

动画文本

LitMotion 支持对 TextMeshPro 文本的零分配动画。以下是如何实现文本动画的示例：

using UnityEngine;
using TMPro;
using LitMotion;

public class TextAnimationExample : MonoBehaviour
{
    [SerializeField] TMP_Text textMeshPro;

    void Start()
    {
        LMotion.String.Create128Bytes("Hello, World!", 5f)
            .WithRichText()
            .WithScrambleChars(ScrambleMode.All)
            .BindToText(textMeshPro);
    }
}

动画事件

你可以通过 WithOnComplete 和 WithOnCancel 方法添加动画完成和取消的回调：

using UnityEngine;
using LitMotion;

public class AnimationEventExample : MonoBehaviour
{
    void Start()
    {
        LMotion.Create(0f, 1f, 2f)
            .WithOnComplete(() => Debug.Log("动画完成"))
            .WithOnCancel(() => Debug.Log("动画取消"))
            .Start();
    }
}

4. 典型生态项目

目前，LitMotion 已经被用于多个 Unity 项目中，用于实现高性能的动画效果。以下是一些典型应用场景：

• 游戏中的角色动画
• UI 元素的动画效果
• 场景中物体的动态效果

通过这些应用案例，可以看出 LitMotion 的强大功能和在实际项目中的实用性。

LitMotion Lightning-fast and Zero Allocation Tween Library for Unity. 项目地址: https://gitcode.com/gh_mirrors/li/LitMotion