3D建模

Cocos Creator：动画控制器（Animation Controller）

ygtu

Jun 10, 2023 • 3 min read

推荐：将NSDT场景编辑器加入你的3D工具链

3D工具集：NSDT简石数字孪生

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

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

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

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

属性

属性	说明
Graph	添加的动画图资源，默认为空

程序化控制动画图

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

方法	说明
`getVariables`	获取所有的变量及变量名/类型/值等相关信息。
`setValue`	设置变量的值。
`getValue`	获取变量的值。
`getCurrentStateStatus`	获取当前状态的信息。
`getCurrentClipStatuses`	获取当前的动画剪辑的状态。
`getCurrentTransition`	获取当前的状态过渡。
`getNextStateStatus`	获取下一个状态的信息。
`getNextClipStatuses`	获取下一个动画剪辑的状态。
`setLayerWeight`	设置某个动画图层级的权重。

变量控制

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

  // 获取动画控制器组件    
  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)

由3D建模学习工作室翻译整理，转载请注明出处！

上一篇：Cocos Creator：动画图资源 (mvrlink.com)

下一篇：Cocos Creator：动画图面板 (mvrlink.com)