【Unity】DOTween的常用函数解释

DOTween插件常用函数解释

1.DOTween.To（通用变化动画）

解释：将某一个值在一定的时间内变化到另一个值（通用的函数），可用于大部分的动画变化

使用示例：

using UnityEngine;
using DG.Tweening; 
​
public class ToTest : MonoBehaviour{
    //移动
    public void To(float duration)
    {
        Vector3 endValue = new Vector3(10, 10, 10); //定义终点值
        DOTween.To
        (
            () => transform.position, //要移动的初始值
            pos => transform.position = pos, //移动过程的位置插值
            endValue, //目标值
            duration //移动耗时（秒）
        );        
    } 
}
​

2.DOMove（移动动画）

解释：将物体从当前位置移动到目标位置

衍生函数：DOMoveX、DOMoveY、DOMoveZ（将物体从当前位置沿着X/Y/Z方向移动）

使用示例：

using UnityEngine;
using DG.Tweening; 
​
public class MoveTest : MonoBehaviour{
    public void MoveToTargetPosition(float duration,Vector3 targetPosition)
    {
        transform.DOMove
        (
            targetPosition, //目标位置
            duration //移动耗时
        );
    }
}
​

3.DOScale（缩放动画）

解释：将物体从当前缩放值变化到目标缩放值

衍生函数：DOScaleX、DOScaleY、DOScaleZ（将物体沿X/Y/Z轴方向缩放）

使用示例：

using UnityEngine;
using DG.Tweening; 
​
public class ScaleTest : MonoBehaviour{
    //缩放到目标缩放值
    public void ScaleToTargetScale(float duration,Vector3 targetScale)
    {
        transform.DOScale
        (
            targetScale, //目标缩放值
            duration //缩放耗时
        );
    }
    
    //基于当前缩放值按倍率进行缩放
     public void ScaleToTargetScale(float duration,float scale)
    {
        transform.DOScale
        (
            scale, //缩放倍率（基于当前倍率）
            duration //缩放耗时
        );
    }
}

4.DOJump（跳跃动画）

解释：将物体从当前位置”跳跃“到目标位置

endValue：结束位置，

jumpPower：跳跃的最大高度，

numJumps：跳跃次数，

jumpPower：持续时间，

snapping：只取整数值（默认为false）

using UnityEngine;
using DG.Tweening;  // 引入命名空间
 
public class Rotate : MonoBehaviour {
    void Start() {
        transform.DOJump(
            new Vector3(2, 2, 2), //结束位置
            4, //跳跃最大高度
            4, //跳跃次数
            5, //持续时间
            false //false表示取浮点数计算，true表示取整数计算
        );
    }
}

5.DOShake（摇晃动画）

解释：模拟随机抖动的效果，无方向性

5.1 位置摇晃

• DOShakePosition(float duration, float/Vector3 strength, int vibrato, float randomness, bool snapping, bool fadeOut)

5.2 旋转摇晃

• DOShakeRotation(float duration, float/Vector3 strength, int vibrato, float randomness, bool fadeOut)

5.3 缩放摇晃

• DOShakeScale(float duration, float/Vector3 strength, int vibrato, float randomness, bool fadeOut)

5.4 参数解释

以下按形参的顺序解释：

duration：持续时间，

strength：晃动幅度（默认为float：1），

vibrato：晃动的次数（默认为10），

randomness：随机晃动角度（0-180，默认为90），

snapping：只取整数值（默认为false），

fadeOut：渐出效果（默认为true）

5.5 示例

using UnityEngine;
using DG.Tweening;  // 引入命名空间
 
public class Shake : MonoBehaviour {
    void Start() {
        transform.DOShakePosition(5);
    }
}

6.DOPunch（击打动画）

解释：该动画可以在位置、旋转、缩放三种形式上模拟表现被强力击打后的震动，有明确的方向性

6.1 位置击打

• DOPunchPosition(Vector3 punch, float duration, int vibrato, float elasticity, bool snapping)

6.2 旋转击打

• DOPunchRotation(Vector3 punch, float duration, int vibrato, float elasticity)

6.3 缩放击打

• DOPunchScale(Vector3 punch, float duration, int vibrato, float elasticity)

6.4 参数解释

以下形参按顺序解释：

punch：击打方向和力度，

duration：持续时间，

vibrato：晃动的次数（默认为10），

elasticity：弹性系数（默认为1），

snapping：只取整数值（默认为false）

6.5 示例

using UnityEngine;
using DG.Tweening;  // 引入命名空间
 
public class Punch : MonoBehaviour {
    void Start() {
        transform.DOPunchPosition(new Vector3(2, 2, 2), 5);
    }
}

7.文字动画

7.1 文字颜色变化

DOColor(Color to, float duration)

• to：当前文字当前颜色要变化到的目标颜色

• duration：变化过程的持续时间

7.2 文字透明度变化

DOFade(float to, float duration)

• to：数值范围是0~1，表示文字当前不透明度要变化到的目标不透明度

• duration：变化过程的持续时间

7.3 打字机动画

DOText(string to, float duration, bool richTextEnabled = true, ScrambleMode scrambleMode = ScrambleMode.None, string scrambleChars = null)

• to：要逐个文字打出的文本

• duration：持续时间

• richTextEnabled：是否支持富文本（默认为True）

• scrambleMode：乱码效果模式（默认为不启用乱码）

• scrambleChars：乱码字符（默认为null）

8.动画序列（重点）

允许你将多个动画组合在一起，以特定的顺序依次执行。适用于需要在特定时间顺序内执行多个动画的场景，例如：角色的移动、跳跃和旋转等多个动作，可以使用序列来组织这些动画。

8.1 顺序动画（Append）

说明：让多个动画按照在序列中的顺序逐个执行

using DG.Tweening;
​
public class SequenceTest : MonoBehaviour{
    // 创建一个空序列
    Sequence sequence = DOTween.Sequence();
    // 添加动画到序列（默认按顺序执行）
    sequence.Append(transform.DOMoveX(5, 1f));  // 第一步：向右移动
    sequence.Append(transform.DORotate(new Vector3(0, 180, 0), 0.5f)); // 第二步：旋转
    sequence.Append(transform.DOScale(Vector3.zero, 1f)); // 第三步：缩小消失
    // 播放序列
    sequence.Play();
}

8.2 并行动画（Join）

说明：让多个动画同时进行。这个特别适合一些需要同时进行的行为，比如某个角色一边移动一边跳跃。

Sequence sequence = DOTween.Sequence();
​
// 第一步：移动和旋转同时进行
sequence.Append(transform.DOMoveX(5, 1f));
sequence.Join(transform.DORotate(new Vector3(0, 180, 0), 1f)); // 与移动同步进行
// 第二步：缩小
sequence.Append(transform.DOScale(Vector3.zero, 0.5f));
sequence.Play();

8.3 动画序列的其它操作

Sequence loopTween = DOTween.Sequence();
将一个新的动画添加到序列的末尾。
loopTween.Append(Tween tween);
​
将一个新的动画添加到序列的开头。
loopTween.Prepend(Tween tween);
​
将一个新的动画添加到序列中，与当前动画同时播放。
loopTween.Join(Tween tween);
​
在指定时间插入一个新的动画。
loopTween.Insert(float time, Tween tween);
​
在序列中添加一个间隔（不执行任何动画的时间）。
loopTween.AppendInterval(float interval): 
​

8.3 暂停、停止、重播、播放序列动画

//播放序列动画
loopTween.Play();
​
//暂停序列动画
loopTween.Pause();
​
//停止序列动画
loopTween.Kill();
​
//重播序列动画
loopTween.Restart();

9.动画缓动（SetEase）

9.1 预设动画缓动表

DOTween为开发者提供了大量的预设好的动画缓动，可以赋予动画不同的运动效果。

9.2 使用示例

transform.DOMove(new Vector3(10,10,10),3f).SetEase(Ease.OutBack);
transform.DOMove(new Vector3(10,10,10),3f).SetEase(Ease.InSine);

10.动画回调函数

说明：动画回调函数类似于Unity的生命周期函数，它允许你在动画的生命周期内执行一些代码。

11.Set相关函数

12.查阅官方文档

除了上述的内容，你还可以查阅DOTween的官方文档，里面提供了插件所包含的全部API

文档连接： DOTween - Documentation