using DG.Tweening;
 
Tweener
首先dotween在游戏刚开始运行时会默认进行一次初始化
DOTween.Init();
如果为了有更好的效率,可以手动控制最大同时进行dotween动作的执行数量,
DOTween.Init(true,true,LogBehavior,Verbose).SetCapacity(200,10);  //200个是tween补间动作,10是squence
 
有三种方式创建tweener动作
1: DOTween.To(getter,setter,to,float duration)
getter, 数值补间动作返回值   setter,数值补间动作的设置值, to 是目标的数值, duration是补间动作的时长
 
getter,和setter的变量一致, 利用lambda表达式来设置
()=>变量A ;  x=>变量A=x
 
如:  float myFloat;   //定义一个float
 
void Start()
{
DOTween.To(()=>myFloat, x=>myFloat=x, 10f,1f);   //让myfloat在一秒内,从myfloat当前值过度到10;
}
 
  DOTween.To(setter,from, to,float duration)    //另一种写的方法, 只写setter,定义 数值的开始和结束值
 
void Start()
{
DOTween.To(x=>myFloat=x, -10f,10f,1f);   //让myfloat在一秒内,从-10过度到10;
}
 
此外还有DOTween.Punch();   //摇晃数值到初始值
//方法原型  
public static TweenerCore<Vector3, Vector3[], Vector3ArrayOptions> Punch(DOGetter<Vector3> getter, DOSetter<Vector3> setter, Vector3 direction, float duration, int vibrato = 10, float elasticity = 1);

//参数1:getter 参数2:setter 参数3:enPos 参数4:duration时间 参数4:晃动的次数 参数5:晃动的幅度
DOTween.Punch(() => myValue, x => myValue = x, new Vector3(100, 100, 100), 3,1,100);

 
DOTween.shake();   //颤抖数值
 
DOTween.ToArray()     //数值集合间过度
如 
Vector3[] endValues = new[] { new Vector3(1,0,1), new Vector3(2,0,2), new Vector3(1,4,1) };
float[] durations = new[] { 1, 1, 1 };
DOTween.ToArray(()=> myVector, x=> myVector = x, endValues, durations);
 
DOTween.ToAlpha()    颜色alpha过度
DOTween.ToAxis();      过度变换 vector3中的某一轴数值
如:
DOTween.ToAxis(()=> myVector, x=> myVector = x, 3, 1);   //始终变换x轴的数值到3,在一秒内
 
DOTween.ToAxis(()=> myVector, x=> myVector = x, 3, 1, AxisConstraint.Y);   //1秒内变换myVector 到(myVector.x,3,myVector.z)
 
 
 
2: 组件后缀形式    (特点是前缀加DO  :DOMove  ,DOScale)
tranform.DOMove(targetVector3, durationTime, isSnap);   //这是从当前位置值移动到目标值
tranform.DOMove(targetVector3, durationTime, isSnap).From();  //这是从targetVector3
值作为起点,移动到当前位置值
 
tranform.DoMove和rigidBody.DoMove.  功能相同;都是移动到目标距离
3 :针对不同组件的属性数值有对应的dotween补间动作值
 
如:audiosource.DOFade(targetVolume,durationTime);//是将声音值过度到对应值
 
 
sequence 
就像动画编辑器一样,在时间轴上布置dotween 动作
布置动作的API有 Append (tweener) AppendCallBack(方法)   
AppendInterval(间隔时间)序列结尾增加间隔时间      
以及PreAppend(tweener) 开头位置 插入 一个tweener
 PreAppendInterval (time)   开头位置插入一个空隙时间  
 
Insert(插入时间,tweener)  无视序列顺序, 同步进行 
InsertCallBack();
 
sequence的总时间 sequence.Duration();
 
如 void Start()
{
Sequence mySequence=DOTween.Sequece();  //定义一个sequence
mySequence.Append(transform.DoMoveX(3f,1f));   //x轴一秒内移动到3
mySequence.AppendInterval(2f);  //延迟2秒
 
mySequence.AppendCallback(()=>Debug.log("2秒后.."));  //两秒后调用一个回调函数
 
mySequence.PreAppend(tranform.DoScale((5f,5f,5f),1f));  //开头插入1秒内一个缩放到(5,5,5)的补间动作
mySequence.PreAppendInterval(1f);//序列开头插入1秒的等待时间
 
mySequence.Insert( 2f, Renderer.Material.DoColor(Color.Green,5f) );   //在序列第二秒插入一个并行的补间动作: 5秒内材质变换成绿色;
}
 
 
 
Chained Setting   代码链式设置    tweener后可以跟随无限个以下方法
如: myTweener.SetEase().SetRelative(true).OnComplete()......;
 
Tweener.SetAs(tweener);   复制设置数值到新的tweener
.SetAutoKill(false)  结束时禁止销毁    适用于经常使用的情况
.SetEase(Ease.Liner)  过度方式
.SetLoop(int 次数,LoopType)
.SetRecycle()   重复利用   不同于SetAutoKill,它会被其他tweener发起者调用
.SetRelative();   相对数值,结束值变成了开始值+结束值  如(1,1f) 移动到1,relative为true后 变成 移动当前数值+1
.SetUpdate(UpdateType, bool isIndenpendant);  update模式, 以及是否受unityENgine的timescale影响  默认false  受影响    尽量不用 fixed 一旦 timescale为0,就没有补间动画
 
Chained Callbacks
.OnComplete(方法)   补间动画结束调用方法
.OnKill()
.OnPlay()
.OnPause()
.Rewind()
.OnStart()
.OnUpdate()
OnWayPointChange()
.OnStep();
 
特殊后缀
.From(bool isRelative)   isRelative 真时, 起始位置为 endPos +StartPos
.SetDelay()
.SetSpeedBased  速度  需要 SetEasy.liner   
 
 
 
字幕的渐显效果
 
string zimu;
DOTween.TO(()=>zimu,x=>zimu=x, "要显示的台词",durationTime).setOption(true,scrambleMode)  ;     //是否使用richtext,以及混乱变换字符
 
 把补间动作设置内容保存成对象,  用setAs(),来调用,方便全局调试
 
TweenParams tParms = new TweenParams().SetLoops(-1).SetEase(Ease.OutElastic);
// Apply them to a couple of tweens
transformA.DOMoveX(15, 1).SetAs(tParms);
transformB.DOMoveY(10, 1).SetAs(tParms);
 
控制补间动画
1
DOTween.pauseAll();  //停止所有补间动画
DOTween.Pause(id) ;//停止制定id的补间动画    id设置     tweener.SetId(object);
DoTWeen.Pause(组件)  //停止组件上的所有补间动画
 
2
tweener.Pause();
 
3
myTransform.DOPause();    //组件快捷方式前缀加DO
 
 
所有控制补间动画的API    (组件后缀名称前缀加DO)     如DOTween.Pause(id)   myTransform.DOPause();
 
Complete/ALL //立即播放到结尾
Flip/All  //反转播放顺序
 
Play/All 
Pause/all
 
PlayForward/All
PlayBackward/all
 
Goto/all   //在某处时间播放
 
Kill/all   //立即销毁tweener ,即使setAutoKill(false)
 
Restart//all
Rewind/all    //和restart 区别是 rewind起始位置不播放
 
TogglePause/all   //play和pause状态间切换
 
根据状态获得tweener
 
DOTween.PausedTweens();  //获得所有暂停的tweener
 
DOTween.PlayingTweens();
 
DOTween.TweenById(object id, bool playingOnly=false);
 
DOTween.TweenByTarget(object target,bool playingOnly=false) //根据组件获得其tweener
 
DOTween.IsTweening(object idor Target) :bool   //目标是否tweening
 
DOTween.TotalPalyingTweens():int   //全部正在播放的tweener个数
 
tweener实例的状态
 
myTweener.fullPosition   //全部播放的时间  包括循环和延迟
 
myTweener.completedLoops  //以及循环的次数
myTweener.Delay();   //获得延迟的时间    myTweener.SetDelay(2f)  是指延迟的时间
 
myTweener.Elapsed(bool includeLoops=true);  //已经播放过的时间
.ElapsedPercentage();
myTweener.Duration(bool includeLoops=true);   //补间动画的时长,不包括延迟的时间
 
myTweener.IsActive();
myTweener.IsBackWard();
myTweener.IsComplete()
myTweener.IsPlaying()
myTweener.loops();
 
 
异步协程
yield return myTween.WaitForCompletion();  //等待tweener结束
 
yield return myTween.WaitForElapsedLoops(2) //等待两次循环后
 
WaitForKill()  //等待销毁后
 
waitForPosition(0.5f)  //等待时间位置在0.5秒后
 
waitForRewind //等待重播
waitForStart()  //等待开始    有延迟的情况
 
 
改变tweener的动画起始和结束值
 
tweener.ChangeEndValue(newEndValue,float duration=-1,bool keepStartValue)  //keepStartValue 为真时,当前值设为开始值  ,duration值大于0,则重设补间时间
 
tweener.ChangeStartValue(newStartValue,float duration=-1)
 
tweener.ChangeValue(newStartValue,newEndValue,float duration=-1);
 
 
DOTVirtual    实用的方法
 
DOTVirtual.Float(float from,float to,float durationTime, Callback);
 
DOTVirtual.Float(-10f,10f,1f,x=>Debug.log(x));     //一秒内从-10到10, 并每帧打印当前过度值
 
DOTVitual.DelayedCall(float delayTime, Callback, bool isIgoreTimeScale=true)   
DOTVitual.DelayedCall(1f,()=>Debug.log("1秒后"));   //延迟一秒后调用指定回调函数
05-11 13:42