AnimeRx 使用教程

AnimeRx 使用教程

AnimeRxRx Tween Animation Library for Unity项目地址:https://gitcode.com/gh_mirrors/an/AnimeRx

1、项目介绍

AnimeRx 是一个为 Unity 设计的 Rx Tween 动画库，它利用 IObservable<T> 接口来实现动画效果。这个库特别适合在 Unity 中处理复杂的动画逻辑，尤其是在 Task 还未在 Unity 中广泛使用时。AnimeRx 提供了丰富的动画控制功能，如缓动函数、动画序列和并行动画等。

2、项目快速启动

安装

1. 通过 Unity 的 Package Manager 导入 AnimeRx：

   https://github.com/kyubuns/AnimeRx.git?path=Assets/Plugins/AnimeRx
   

2. 或者直接下载并导入 Unity 包文件到你的项目中。

基本使用

以下是一个简单的示例，展示如何使用 AnimeRx 创建一个从 (-5, 0, 0) 到 (5, 0, 0) 的动画：

using UnityEngine;
using AnimeRx;

public class BasicAnimation : MonoBehaviour
{
    void Start()
    {
        Anime.Play(new Vector3(-5f, 0f, 0f), new Vector3(5f, 0f, 0f), Motion.Uniform(5f))
             .SubscribeToPosition(transform);
    }
}

3、应用案例和最佳实践

案例1：循环动画

创建一个无限循环的动画：

void Start()
{
    var disposable = Anime.Play(new Vector3(-5f, 0f, 0f), new Vector3(5f, 0f, 0f), Motion.Uniform(5f))
                          .Repeat()
                          .SubscribeToPosition(transform);
}

案例2：组合动画

组合多个动画效果：

void Start()
{
    var x = Anime.Play(-5f, 5f, Easing.InOutSine(3f));
    var y = Anime.Play(0f, 3f, Easing.InOutSine(1.5f));
    var z = Anime.Stay(0f);

    Observable.CombineLatest(x, y, z)
              .SubscribeToPosition(transform);
}

4、典型生态项目

AnimeRx 可以与 UniTask 结合使用，进一步提升动画处理的性能和灵活性。UniTask 是一个为 Unity 设计的异步任务库，它提供了更高效的任务处理机制。

结合 UniTask

using Cysharp.Threading.Tasks;

async UniTask Start()
{
    await Anime.Play(new Vector3(-5f, 0f, 0f), new Vector3(5f, 0f, 0f), Motion.Uniform(5f))
               .ToUniTask(this.GetCancellationTokenOnDestroy());
}

通过结合 UniTask，你可以更方便地管理异步动画任务，并确保在对象销毁时正确取消任务。

AnimeRxRx Tween Animation Library for Unity项目地址:https://gitcode.com/gh_mirrors/an/AnimeRx