动画控制器（Animation Controller）组件参考

动画控制器组件用于将 动画图资源 应用到对象上。

在 层级管理器 中选中需要应用动画图的节点，然后在 属性检查器 中点击下方的 添加组件 -> Animation -> Animation Controller，即可添加一个动画控制器组件到节点上。

注意：因为 Marionette 动画系统与旧式动画系统不可同时使用，因此 动画控制器组件也不能和动画组件或者骨骼动画组件挂载在同一个节点上。

属性

程序化控制动画图

动画控制器组件提供了一些方法用于在运行时控制动画图的 动画状态机：

• 变量 控制

  例如我们在 动画图面板 添加了多个变量，通过代码可以获取和修改变量的值，代码示例如下：

    // 获取动画控制器组件    
    let animationController:animation.AnimationController = this.node.getComponent(animation.AnimationController)
  
    // 获取所有的变量
    let variables= animationController.getVariables();
  
    // 获取名为 ‘vertical’ 的变量的值
    let vertical: Number = animationController.getValue("vertical");
  
    // 修改名为 ‘vertical’ 的变量的值为 1.0。修改后，将会在下一帧 update 的时候计算条件过渡
    animationController.setValue("vertical", 1.0)
  

  注意：动画状态机的变量目前只能在 动画图面板 进行添加和删除。

• 获取当前 状态

  获取第 0 层级状态机当前 状态 的归一化进度，代码示例如下：

    let states: animation.MotionStateStatus = animationController.getCurrentStateStatus(0)
    console.log(states.progress);
  

• 获取当前 过渡

  获取第 0 层级状态机即将发生的 过渡 的相关信息：

    let transition: animation.TransitionStatus = animationController.getCurrentTransition(0)
    console.log(transition.duration, transition.time)