Unity3d C#使用DOTween插件的Sequence实现系列动画OnComplete无效和颜色设置无效的问题记录
前言
最近在弄一个文字动画效果的动画，使用了DOTween插件的Sequence来实现，主要就是对一个Text进行的文字打字、缩放和颜色设置等动画，功能是先对Text实现打字的动画，打字完成后，延时几秒对文字进行缩小、颜色变淡（逐渐透明的效果）的过程，在这个过程完成后，重置缩放比例和颜色（透明度），继续重复上一步的动作，直到所有结束。想象中的效果如下：
然而，理想很丰满，现实很骨干，当我按这个思路编码后并不能实现上面的效果，而是这样的效果：
不错没有卡，只进行了第一步的动画…
而我的编码完全是根据如上的思路编写：
TipText.transform.localScale = Vector3.one;
TipText.color = new Color32(255, 255, 255, 255);
Sequence seq1 = DOTween.Sequence();
seq1.Append(TipText.DOText("这是!!!", 1f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f)).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
TipText.text = "";
});
seq1.Append(TipText.DOText("DOTween插件的.....", 2f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f)).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one * 2;
TipText.text = "";
});
seq1.Append(TipText.DOText("超级大Bug！！！", 2f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f)).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
TipText.text = "";
});
seq1.Append(TipText.DOText("Sequence OnComplete无效&Text.color设置无效。", 4f));
seq1.Play();
修改过程
如上的问题很直接的能看出是只进行了第一步的动画，而在Inspector上还是能明显的看出来，后续动画也进行了：
只不过text的状态没有重置，也就是没有进入OnComplete函数，造成了缩放，特别是透明度一直是0，所以就不可见，这点我在OnComplete函数中打了log验证了。还有一点是最后一个Append函数的log输出了，也就是执行了。
然后我将OnComplete函数从Join放到了Append上：
seq1.Append(TipText.DOText("这是!!!", 1f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f)).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
TipText.text = "";
});
转换后：
seq1.Append(TipText.DOText("这是!!!", 1f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f)).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
Debug.Log(TipText.text);
TipText.text = "";
});
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f));
效果还是一样的，也没有进入OnComplete函数，经过很长时间的琢磨、查文档和检查代码，终于发现OnComplete函数的放在了外层，应该放到DOScale函数的一层，而我误将其放到了Append函数层了。
正确的应该这样修改：
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f).OnComplete(() => {
}));
进行了如上修改后，OnComplete函数里的日志都输出了：
不过效果还是同最开始的动画，查看后发现虽然执行了OnComplete函数但是颜色修改的语句没实现或者被什么还原了：
我感觉可能被seq1.Join(TipText.DOColor())函数影响了，我尝试将DOColor的缩小duration（2–> 1.8）一点试试：
TipText.transform.localScale = Vector3.one;
TipText.color = new Color32(255, 255, 255, 255);
Sequence seq1 = DOTween.Sequence();
seq1.Append(TipText.DOText("这是!!!", 1f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
Debug.Log(TipText.text);
TipText.text = "";
}));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 1.8f));
seq1.Append(TipText.DOText("DOTween插件的.....", 2f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one * 2;
Debug.Log(TipText.text);
TipText.text = "";
}));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 1.8f));
seq1.Append(TipText.DOText("超级大Bug！！！", 2f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
Debug.Log(TipText.text);
TipText.text = "";
}));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 1.8f));
seq1.Append(TipText.DOText("Sequence OnComplete无效&Text.color设置无效。", 4f).OnComplete(() => {
Debug.Log("执行完成");
}));
seq1.Play();
终于正常了：
这样就说明了DOColor还原了OnComplete设置的颜色值。
如果真是这样的话，我刚开始OnComplete不执行的问题是因为写错OnComplete函数的层级的问题，再引起了无法设置颜色的问题，如果我一开始就在DOColor上正确的OnComplete就没有这些问题了？验证这个问题，我又还原了最开始的代码并修正了OnComplete层级错误的问题：
TipText.transform.localScale = Vector3.one;
TipText.color = new Color32(255, 255, 255, 255);
Sequence seq1 = DOTween.Sequence();
seq1.Append(TipText.DOText("这是!!!", 1f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
Debug.Log(TipText.text);
TipText.text = "";
}));
seq1.Append(TipText.DOText("DOTween插件的.....", 2f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one * 2;
Debug.Log(TipText.text);
TipText.text = "";
}));
seq1.Append(TipText.DOText("超级大Bug！！！", 2f));
seq1.AppendInterval(1);
seq1.Append(TipText.transform.DOScale(new Vector3(0.1f, 0.1f, 0.1f), 2f));
seq1.Join(TipText.DOColor(new Color32(255, 255, 255, 0), 2f).OnComplete(() => {
TipText.color = new Color32(255, 255, 255, 255);
TipText.transform.localScale = Vector3.one;
Debug.Log(TipText.text);
TipText.text = "";
}));
seq1.Append(TipText.DOText("Sequence OnComplete无效&Text.color设置无效。", 4f).OnComplete(() => {
Debug.Log("执行完成");
}));
seq1.Play();
也得到了正确的效果！！！
问题总结
OnComplete不执行
这里的OnComplete不执行的问题就是因为层级的问题，这个我是很少犯这种错误的，但是这次也是搞的自己一头雾水。
颜色设置无效
这个应该是系列问题，如果颜色、缩放、位置等属性，在其它并行动画结束事件中修改这些属性的话，可能会有这类的异常，如上我的测试可以看出，如果DOFade/DOColor的执行时间少于，结束事件动画的执行时间，还是可以的，这样的话，如果动画过程并行复杂的情况，处理起来会很复杂的。所以建议还是动画过程关联的属性自己在结束事件中修改这些属性。例如：
颜色/透明度（DOFade/DOColor）
DOFade/DOColor(属性, 时间)..OnComplete(() => {
//这里修改颜色/透明度
});
缩放（DOScale/DOScaleX/DOScaleY/DOScaleZ）
DOScale/DOScaleX/DOScaleY/DOScaleZ(属性, 时间)..OnComplete(() => {
//这里修改位置
});
缩放（DOScale/DOScaleX/DOScaleY/DOScaleZ）
DOScale/DOScaleX/DOScaleY/DOScaleZ(属性, 时间)..OnComplete(() => {
//这里修改大小
});
移动（DOMove/DOMoveX/DOMoveY/DOMoveZ…）
DOMove/DOMoveX/DOMoveY/DOMoveZ...(属性, 时间)..OnComplete(() => {
//这里修改位置
});
…
以此类比修改。
本文内容基于DOTweenPro v1.0.244测试再现问题，仅供参考。