动画插件DOTween.To的使用详解

一、DOTween.To是什么

DOTween.To是一款针对Unity引擎的动画插件，可以极大地简化动画制作的流程，增强了动画的表现力。它的主要功能是用于在Unity场景中控制和创建Tween动画。DOTween.To拥有灵活的API，支持多种动画效果，非常适合用于UI交互元素和对象的动画制作。

下面我们来看一个使用DOTween.To创建Tween动画的示例：

DOTween.To(() => transform.position, x => transform.position = x, new Vector3(0f, 0f, 0f), 1f)
    .SetEase(Ease.OutQuint);

这段代码的作用是让某个物体在1秒内沿着x、y、z坐标轴的位置向(0,0,0)移动，并且动画效果为缓出。其中SetEase()函数用于设置动画效果类型。

二、DOTween.To的常用API

1. DOTween.To()

DOTween.To()函数是DOTween.To的核心API，用于创建简单的动画，参数如下：

• getter：取值方法，在动画中会被不断调用以获取属性的当前值。
• setter：设置方法，在动画中会被不断调用以设置属性的值。
• endValue：属性的目标值。
• duration：动画的持续时间。

下面是一个使用DOTween.To()创建动画的示例：

public Vector3 moveTarget;

private void OnMouseDown()
{
    DOTween.To(() => transform.position, x => transform.position = x, moveTarget, 1f);
}

这段代码的作用是让某个物体在鼠标点击事件发生时移动到指定位置moveTarget。一旦物体被点击，Tween动画就会开始，并在1秒钟内将物体移动到目标位置。

2. SetEase()

SetEase()函数用于设置Tween动画的缓动效果。DOTween.To()中预定义了常用的缓动效果类型，例如Ease.Linear, Ease.OutSine, Ease.InOutQuint等。这些效果类型可以通过SetEase()函数直接应用到动画上，例如：

DOTween.To(() => transform.position, x => transform.position = x, moveTarget, 1f)
    .SetEase(Ease.OutQuint);

这段代码的作用是让Tween动画在结束时应用Ease.OutQuint缓动效果。

3. OnComplete()

OnComplete()函数用于设置Tween动画结束时的回调函数。回调函数可以是任何C#委托类型的方法，例如Action、Func等，可以执行特定的逻辑操作或调用其他方法。例如：

DOTween.To(() => transform.position, x => transform.position = x, moveTarget, 1f)
    .SetEase(Ease.OutQuint)
    .OnComplete(() => Debug.Log("Tween animation complete!"));

这段代码的作用是在Tween动画结束时输出一段调试信息。

三、DOTween.To的高级用法

1. 多个Tween动画的组合

当需要在同一对象上实现多个Tween动画时，可以使用序列和并行动画。

1.1 DOTween.Sequence()

DOTween.Sequence()函数用于创建一个Tween动画序列，使多个Tween动画按照指定的顺序逐个播放。例如：

Sequence mySequence = DOTween.Sequence();
mySequence.Append(DOTween.To(() => transform.position, x => transform.position = x, new Vector3(0f, 0f, 0f), 1f));
mySequence.Append(DOTween.To(() => transform.localScale, x => transform.localScale = x, new Vector3(2f, 2f, 2f), 1f));
mySequence.Play();

这段代码的作用是创建一个序列动画，首先将物体移动到(0,0,0)的位置，接着将物体缩放为原来的2倍，整个动画的持续时间为2秒钟。

1.2 DOTween.Parallel()

DOTween.Parallel()函数用于创建一个Tween动画集合，使多个Tween动画同时播放。例如：

Sequence myParallel = DOTween.Parallel();
myParallel.Append(DOTween.To(() => transform.position, x => transform.position = x, new Vector3(0f, 0f, 0f), 1f));
myParallel.Append(DOTween.To(() => transform.localScale, x => transform.localScale = x, new Vector3(2f, 2f, 2f), 1f));
myParallel.Play();

这段代码的作用是创建一个集合动画，同时播放将物体移动到(0,0,0)的位置和将物体缩放为原来的2倍的Tween动画，整个动画的持续时间为1秒钟。

2. 自定义动画插值函数

在Tween动画中，除了预定义的颜色、摄像机等数据类型外，也可以自定义数据类型，以便使用DOTween.To()函数针对这些数据类型创建Tween动画，这时候需要自定义插值函数Lerp()。例如：

public struct MyData
{
    public float x;
    public float y;
    public float z;

    public static MyData Lerp(MyData a, MyData b, float t)
    {
        MyData result = new MyData();
        result.x = Mathf.Lerp(a.x, b.x, t);
        result.y = Mathf.Lerp(a.y, b.y, t);
        result.z = Mathf.Lerp(a.z, b.z, t);
        return result;
    }
}

private void OnMouseDown()
{
    MyData startValue = new MyData();
    startValue.x = 0f;
    startValue.y = 0f;
    startValue.z = 0f;

    MyData endValue = new MyData();
    endValue.x = 5f;
    endValue.y = 10f;
    endValue.z = 15f;

    DOTween.To(() => startValue, x => startValue = x, endValue, 1f)
        .SetEase(Ease.OutQuint)
        .OnComplete(() => Debug.Log("Tween animation complete!"))
        .OnUpdate(() => {
            transform.position = new Vector3(startValue.x, startValue.y, startValue.z);
        })
        .SetTarget(gameObject)
        .SetAsCached();
}

这段代码的作用是自定义了一个数据类型MyData并实现了自己的插值函数Lerp()。在鼠标点击事件发生时，开始一个Tween动画，并将自定义数据类型MyData作为Tween动画的起始值和终止值。动画完成后输出一段调试信息，并将物体的位置设置为Tween动画的当前值。

3. 快速寻找Tween动画

当在场景中使用了大量的Tween动画，需要通过Tween动画名快速寻找Tween动画时，可以使用DOTween里的静态API方法。

3.1 DOTween.Sequence()

DOTween.Sequence()方法创建并直接启动一个Tween动画，可以在方法中添加Tween动画序列中的所有动画，启动后可以使用静态方法DOTween.Sequence()来寻找并操作这个Tween动画序列。例如：

SimpleButton[] buttons = GetComponentsInChildren();
Sequence mySequence = DOTween.Sequence().Append(buttons[0].transform.DOMoveY(buttons[0].transform.position.y + 90f, 1f));
mySequence.Append(buttons[1].transform.DOMoveY(buttons[1].transform.position.y - 90f , 1f));
mySequence.SetEase(Ease.InOutSine);
mySequence.SetLoops(-1, LoopType.Yoyo);
mySequence.SetAutoKill(false);

// 快速通过Tween动画名寻找Tween动画，并启动、停止、暂停等操作
DOTween.Sequence("myAnim").Join(mySequence).Pause();
DOTween.Pause("myAnim");
DOTween.Play("myAnim");

  

这段代码的作用是创建一个动画序列，在动画序列中每个按钮在垂直方向上来回移动。使用DOTween.Sequence()方法创建动画序列实例，并将Tween动画的引用放到mySequence序列对象中。然后通过DOTween.Sequence()静态API方法快速寻找这个Tween动画序列，并对其进行操作。

3.2 DOTween.TweensById()

DOTween.TweensById()方法用于通过Tween动画名来查找Tween动画，返回Tween动画对象列表。例如：

Tween[] tweens = DOTween.TweensById("myAnim");
foreach (Tween tween in tweens)
{
    tween.PlayForward();
}

这段代码的作用是查找Tween动画名为"myAnim"的动画，并将它们全部向前播放。

四、总结

DOTween.To是一款极为优秀的动画插件，它提供了丰富灵活的API，为我们在游戏开发中提供了很大的帮助。在制作Tween动画时，特别是针对UI和对象的动画效果，DOTween.To都能够提供便利，使开发人员可以更快速、更高效地实现游戏动画效果的制作。