动画状态

动画剪辑仅描述某一类对象的动画数据，例如角色的跑、走、跳等，但并未绑定具体要执行动画的对象。动画状态便是用于控制在某个对象上使用的动画剪辑，类似于播放机，除了提供动画组件也有的简单的控制函数外，还提供了更多的动画信息以及动画控制接口，允许对动画播放进行调速、设置循环模式等控制。一个动画剪辑可以同时被多个动画状态使用。

动画状态由 类 AnimationState 管理。

设置播放速度

首先可以通过 getState() 获取动画状态：

// 获取动画组件
const animationComponent = node.getComponent(Animation);
// 获取动画组件上的动画剪辑
const [ idleClip, runClip ] = animationComponent.clips;
// 获取 idleClip 的动画状态
const idleState = animationComponent.getState(idleClip.name);

然后设置动画播放的速度：

// 以二倍速播放 idleClip 动画
animationComponent.getState('idle').speed = 2.0; // speed 值越大速度越快，值越小则速度越慢

动画状态也提供了 play()、pause()、resume()、stop() 等用于播放控制的方法，详情可参考下文 播放状态 部分的内容。

播放时间

动画状态记录了动画的 累计播放时间。初始时累计播放时间为 0。当动画自然播放时，时间会不断累计。例如，当动画循环播放时，刚好第二次循环完毕后，累计播放时间将为 动画周期 * 2。

任意时刻动画所处的播放位置称为 进度时间，因此进度时间总是在 [0, 动画周期] 范围内。

• 累计播放时间 由 AnimationState 的 time 字段获取，并且可以显式设置。
• 进度时间 由 AnimationState 的 current 字段获取，是 只读 的。

动画播放的循环模式与循环次数决定了累计播放至某一时间时动画的进度时间，不管 累计播放时间 因为时间的推移而增加还是因为直接设置而更改，进度时间 都会相应发生改变。

循环模式与循环次数

动画可以播放到结尾就停止，或者一直循环播放，或者也可以先播放到结尾再从结尾播放到开头如此循环，这些统称为循环模式，由枚举 AnimationClip.WrapMode 表示，包括以下几种：

除此之外，上表中的每种循环模式还存在对应的 反向 循环模式：

动画状态的初始循环模式将从动画剪辑中读取。需要改变动画状态的循环模式时，简单地设置动画状态的 wrapMode 字段即可。

注意：设置循环模式时会重置动画状态的 累计播放时间。

除 AnimationClip.WrapMode.Normal 和其对应的 AnimationClip.WrapMode.Reverse 外（它们可以理解为单次循环），其余的循环模式执行的都是无限次循环。无限次循环需要与 AnimationState 的 repeatCount 配合使用才能达到效果，并且可以通过 repeatCount 字段来设置和获取循环的次数。

当动画循环模式为：

• 单次循环模式：repeatCount 将被设置为 1。
• 无限次循环模式：repeatCount 将被设置为 Number.Infinity，即无限循环。

注意：设置循环次数应该在设置循环模式之后进行，因为重新设置循环模式时会重置循环次数。

播放控制

动画状态提供了以下几种方法用于控制动画的播放、暂停、恢复和停止：

也可以通过以下字段查询动画的播放状态：

播放控制与播放状态之间的关系如下图所示：

通过动画状态可以获取到所有动画的信息，以便利用这些信息来判断需要做哪些事，更多接口请参考 类 AnimationState。