facebook twitter hatena line email

Unity/Csharp/DoTween

提供: 初心者エンジニアの簡易メモ
2022年9月10日 (土) 22:41時点におけるAdmin (トーク | 投稿記録)による版 (色変更)

移動: 案内検索

dotweenとは

アニメーションライブラリ

参考:https://qiita.com/broken55/items/df152c061da759ad1471

インストール

  1. unityassetsからdotweenを検索して、
  2. dotweenのfree ( https://assetstore.unity.com/packages/tools/animation/dotween-hotween-v2-27676 ) をダウンロード
  3. installし、
  4. importする
  5. OpenDoTweenUtilityPanelを開き
  6. SetupDotweenボタンを押して、Applyを押す。

サンプル

x=2、y=3のrootから見た座標に1秒後に移動する。

using DG.Tweening;
using UnityEngine;
public class SampleScene : MonoBehaviour
{
    void Start()
    {
        GameObject.Find("Image").transform.DOLocalMove(new Vector3(2f, 3f, 0f), 1f);
    }
}

Xだけ動かす

GameObject.Find("Image").transform.DOLocalMoveX(2f, 1f);

繰り返し

無限繰り返し

GameObject.Find("Image").transform.DOLocalMove(new Vector3(2f, 3f, 0f), 1f)
.SetLoops(-1, LoopType.Restart);

2回指定

GameObject.Find("Image").transform.DOLocalMove(new Vector3(2f, 3f, 0f), 1f)
.SetLoops(2, LoopType.Restart);

4回往復

.SetLoops(4, LoopType.Yoyo)

遅延動作

5秒待ってから動作

.SetDelay(5f);

Easeの動き

.SetEase(Ease.Linear); // 線形
.SetEase(Ease.OutSine); // 最初速く後ゆっくり
.SetEase(Ease.InExpo); // 最初ゆっくり後速く

https://github.com/Nightonke/WoWoViewPager/blob/master/Pictures/ease.png

動きを止める

オブジェクト指定

DOTween.Kill(this.transform);

tweenインスタンスを作って止める

Tween tween = GameObject.Find("Image").transform.DOLocalMove(new Vector3(2f, 3f, 0f), 1f);
tween.Kill();

参考:https://qiita.com/broken55/items/df152c061da759ad1471

絶対座標

DOMoveとする

GameObject.Find("Image").transform.DOMove(new Vector3(2f, 3f, 0f), 1f);

ローカル座標

DOLocalMoveとする

GameObject.Find("Image").transform.DOLocalMove(new Vector3(2f, 3f, 0f), 1f);

回転

5秒で、x方向に90度回転

.DORotate(Vector3.right * 90f, 5f, RotateMode.LocalAxisAdd)

5秒で、y方向に90度回転

.DORotate(Vector3.up * 90f, 5f, RotateMode.LocalAxisAdd)

5秒で、z方向に90度回転

.DORotate(Vector3.forward * 90f, 5f, RotateMode.LocalAxisAdd)

5秒で、z方向に90度回転を、ループで、速度均等に

.DORotate(Vector3.forward * 360f, 5f, RotateMode.LocalAxisAdd).SetLoops(-1, LoopType.Restart).SetEase(Ease.Linear);

参考:https://qiita.com/BEATnonanka/items/b4cca6471e77466cec74

回転2D

30秒で一回転で、左回り

.DOLocalRotate(new Vector3(0, 0, 360f), 30f, RotateMode.FastBeyond360)
.SetEase(Ease.Linear)
.SetLoops(-1, LoopType.Restart);

右回り

imgRenew.transform.DOLocalRotate(new Vector3(0, 0, -360f), 30f, RotateMode.FastBeyond360)
.SetEase(Ease.Linear)
.SetLoops(-1, LoopType.Restart);

色変更

5秒で青へ

Image image = GameObject.Find("Image").GetComponent<Image>();
image.DOColor(Color.blue, 5f).SetEase(Ease.Linear);

マテリアルを1秒で赤へ

GameObject cubeObj;
cubeObj.GetComponent<MeshRenderer>().material.DOColor(Color.red, 1f);

徐々に透明へ

透明度を10秒で0%へ

image.DOFade(endValue: 0f, duration: 10f);

徐々に透明3Dオブジェクト

unity/3d/透明 [ショートカット]

void TransparentAllUnderObject(GameObject obj)
{
    if (obj.GetComponent<SkinnedMeshRenderer>() != null)
    {
        Material[] materials = obj.GetComponent<SkinnedMeshRenderer>().materials;
        if (materials.Length > 0)
        {
            materials[0].shader = Shader.Find("Custom/SemiTransparent");
            obj.GetComponent<SkinnedMeshRenderer>().materials[0].DOFade(endValue: 0f, duration: 1f);
        }
    }
    if (obj.GetComponent<MeshRenderer>() != null)
    {
        Material[] materials = obj.GetComponent<MeshRenderer>().materials;
        if (materials.Length > 0)
        {
            materials[0].shader = Shader.Find("Custom/SemiTransparent");
            obj.GetComponent<SkinnedMeshRenderer>().materials[0].DOFade(endValue: 0f, duration: 1f);
        }
    }
    Transform transforms = obj.GetComponentInChildren<Transform>();
    if (transforms.childCount > 0)
    {
        foreach (Transform transform in transforms)
        {
            TransparentAllUnderObject(transform.gameObject); // 再帰処理
        }
    }
}

参考:https://nn-hokuson.hatenablog.com/entry/2018/01/23/202530

拡大縮小

obj.transform.DOScale(new Vector3(1f, 1f, 0f), 1.0f);
obj.transform.DOScaleX(1f, 1.0f);
obj.transform.DOScaleY(1f, 1.0f);

振動

1秒間、強さ5で震える

obj.transform.DOShakePosition(duration: 1f, strength: 5);

1秒間に震える(オプション付き)

obj.transform.DOShakePosition(duration: 1, strength: 5, vibrato: 30, fadeOut: false)

敵にやられたときなど

obj.transform.DOShakePosition(duration: 0.3f, strength: 0.25f, vibrato:30, randomness:1, snapping:false, fadeOut:true);
  • 振動時間
  • 振動する強さ
  • 振動数
  • 手ブレ値
  • スナップフラグ
  • フェードアウト

指定座標の上を移動する

  • 2Dの場合は、PathMode.Sidescroller2Dを追加する。
  • SetLookAtは、傾きが変わるx秒前に正面の向きを変える
Vector3[] movepath =
{
    new Vector3(0f,0f,0f),
    new Vector3(0f,100f,0f),
    new Vector3(100f,100f,0f),
    new Vector3(100f,0f,0f),
    new Vector3(0f,0f,0f)
};
GameObject.Find("Image").transform.DOLocalPath(movepath, 5f, PathType.Linear, PathMode.Sidescroller2D)
    .SetLookAt(0.1f)
    .SetLoops(-1, LoopType.Restart);

曲線でつなぐ

Vector3[] movepath =
{
    new Vector3(0f,0f,0f),
    new Vector3(200f,-100f,0f),
    new Vector3(400f,-300f,0f),
};
GameObject.Find("Image").transform.DOLocalPath(movepath, 0.5f, PathType.CatmullRom, PathMode.Sidescroller2D)
    .SetEase(Ease.Linear)
    .SetLookAt(0.1f)
    .SetLoops(-1, LoopType.Restart);

完了したら関数実行

パターン1

GameObject.Find("Image").transform.DOPath(movepath, 5f, PathType.Linear, PathMode.Sidescroller2D).OnComplete(CallbackComplete);
}
void CallbackComplete()
{
    Debug.Log("CallbackComplete");
}

パターン2

GameObject.Find("Image").transform.DOPath(movepath, 5f, PathType.Linear, PathMode.Sidescroller2D).OnComplete(() =>
{
    Debug.Log("CallbackComplete");
});

コールバック一覧

.OnComplete(Callback);
.OnStart(Callback);
.OnUpdate(Callback);
.OnKill(Callback);

複数動作をつなげる

var sequence = DOTween.Sequence();
sequence.Append(this.transform.DOMove(new Vector3(1f, 3f, 0f), 1f));
sequence.Append(this.transform.DOMove(new Vector3(2f, 4f, 0f), 1f));
sequence.Play();

複数同時実行をつなげる

var sequence = DOTween.Sequence();
sequence.Append(this.transform.DOMove(new Vector3(1f, 3f, 0f), 1f));
sequence.Append(this.transform.DOMove(new Vector3(2f, 4f, 0f), 1f));
sequence.Join(this.transform.DOScale(Vector3.one * 3f, 1f)); // 1つ前と同時に実行
sequence.Join(this.transform.DORotate(new Vector3(0, 0, 360f), 1f, RotateMode.FastBeyond360)); // 1つ前と同時に実行
sequence.Play();

移動しながら、徐々に表示されるように

hogeText.color = new Vector4(hogeText.color.r, hogeText.color.g, hogeText.color.b, 0f);
var sequence = DOTween.Sequence();
sequence.Append(hogeObj.transform.DOLocalMoveY(10, 0.1f));
sequence.Join(hogeText.DOFade(endValue: 1f, duration: 0.15f));
sequence.Play();

上に移動しながら、文字が消える

TextMeshPro textPro = hogeObj.GetComponent<TextMeshPro>();
textPro.color = new Color(textPro.color.r, textPro.color.g, textPro.color.b, 1);
Color color = new Color(textPro.color.r, textPro.color.g, textPro.color.b, 0f);
sequence = DOTween.Sequence();
sequence.Append(hogeObj.transform.DOLocalMoveY(4f, 1f));
sequence.Join(textPro.DOColor(color, 1f));
sequence.Play();

or

Text text = obj.GetComponent<Text>();
Color color = new Color(1f, 1f, 1f, 0f);
Sequence sequence = DOTween.Sequence();
sequence.Append(obj.transform.DOLocalMoveY(obj.transform.localPosition.y + 200f, 0.5f));
sequence.Join(DOTween.ToAlpha(
    () => text.color,
    color => text.color = color,
    0f,
    0.5f
).SetEase(Ease.InCubic));
sequence.Play();

テキストカウントアップ

int start = 10;
int end = 1000;
DOTween.To(() => start, (n) => start = n, end, 1)
    .OnUpdate(() => text.text = start.ToString("#,0"));

参考:http://halcyonsystemblog.jp/blog-entry-524.html

数秒遅延

DOVirtual.DelayedCall(2.0f, () => {
   // 2秒後実行
});

完了するまで処理を待機する

UniTaskなどを使ってasyncを使う。

async void BasicAsync()
{
    await GameObject.Find("Image").transform.DOMove(new Vector3(3f, 3f, 0f), 2f)
        // .SetEase(Ease.InExpo)
        .SetEase(Ease.Linear)
        .AsyncWaitForCompletion();
    Debug.Log("完了");
}

sequenceの場合

await sequence.AsyncWaitForCompletion();

元シーン削除でTweenを削除する方法

transform
    .DOMoveX(2, 2)
    .SetLink(gameObject);

参考:https://baba-s.hatenablog.com/entry/2020/03/02/151500

遅延実行

DOVirtual.DelayedCall(5f, () =>
{
    // 処理
});

自作テンプレモーション

テレビのように開く

this.transform.localScale = new Vector3(0f, 0f, 0f);
var sequence = DOTween.Sequence();
sequence.Append(this.transform.DOScale(new Vector3(1f, 0.005f, 1f), 0.2f).SetEase(Ease.InOutCubic));
sequence.Append(this.transform.DOScale(new Vector3(1f, 1f, 1f), 0.2f).SetEase(Ease.InOutCubic));
sequence.Play();

テレビのように閉じる

this.transform.localScale = new Vector3(1f, 1f, 1f);
var sequence = DOTween.Sequence();
sequence.Append(this.transform.DOScale(new Vector3(1f, 0.005f, 1f), 0.2f).SetEase(Ease.InOutCubic));
sequence.Append(this.transform.DOScale(new Vector3(0f, 0f, 0f), 0.2f).SetEase(Ease.InOutCubic));
sequence.Play();

星型に移動する

  • root座標のときは、DOPathを使う。
Vector3[] movepath = new Vector3[6];
movepath[0].Set(0f, 1f, 0f); // 1
movepath[1].Set(0.5878f, -0.8090f, 0f); // 5
movepath[2].Set(-0.9511f, 0.3090f, 0f); // 9
movepath[3].Set(0.9511f , 0.3090f, 0f); // 3
movepath[4].Set(-0.5878f, -0.8090f, 0f); // 7
movepath[5].Set(0f, 1f, 0f); // 1
// 星型頂点 https://detail.chiebukuro.yahoo.co.jp/qa/question_detail/q10137274530
GameObject.Find("Image").transform.DOPath(movepath, 5f, PathType.Linear, PathMode.Sidescroller2D)
            .SetLookAt(0.01f)
            .SetLoops(-1, LoopType.Restart);

ローカル値を使う場合は、DOLocalPathを使う

参考:https://qiita.com/BEATnonanka/items/50cacac803f88f5074dd

縮小してきて震える

messageObj.transform.localScale = new Vector3(20f, 20f, messageObj.transform.localScale.z);
Vector3 initPosition = messageObj.transform.localPosition;
var sequence = DOTween.Sequence();
sequence.Append(messageObj.transform.DOScale(Vector3.one, 0.2f).SetEase(Ease.OutBack));
sequence.Append(messageObj.transform.DOShakePosition(duration: 0.2f, strength: 50f, vibrato: 30, fadeOut: false).SetDelay(0.2f));
sequence.Play().OnComplete(() =>
{
      messageObj.transform.localPosition = initPosition;
});

サンプルモーション

ボタンフェードイン表示

obj.transform.localScale = Vector3.zero;
obj.transform.DOScale(1f, 1f).SetEase(Ease.OutBounce);

参考:https://unity-yuji.xyz/dotween-good-game-ui/

上下移動サンプル

obj.transform
            .DOMoveY(obj.transform.position.y  - 0.1f, duration: 1f)
            .SetEase(Ease.Linear)
            .SetLoops(-1, LoopType.Yoyo)
            .Play();

参考:https://qiita.com/azumagoro/items/d97a07cff212a664461b

外部サイトサンプルモーション

DOTweenで作成したモーション17個を含むプロジェクトを公開 https://game-ui.net/?p=975

The type 'TweenerCore<,,>' is definedエラーが出る場合

詳しいエラーは以下の通り

The type 'TweenerCore<,,>' is defined in an assembly that is not referenced. You must add a reference to assembly 'DOTween, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null'.

PCを再起動で直った。