POBDS / 12
播放人物动画
在角色对象或子物体上挂载 Animator,并配置 Controller。填写状态名、层索引和过渡时间,用逻辑毫秒配置完成时机。缺少 Animator、Controller 或状态时会失败并给出原因。
关键配置
参数与引脚
| 参数名 | 类型 | 方向 | 默认值 | 说明 |
|---|---|---|---|---|
| StateName | String | configuration | "Idle" | Animator 状态名或完整路径,例如 Base Layer.Attack;不是动画文件名。 |
| DurationMs | Int32 | configuration | 0 | 持续毫秒数;整数模拟时间。 |
| BlendMs | Int32 | configuration | 100 | 动画过渡时长,单位毫秒;0 表示立即播放。 |
| Layer | Int32 | configuration | 0 | Animator 层索引,从 0 开始;状态必须存在于所选层。 |
| FlowAction.Delay | Float (s) | configuration | 0 | 此动作进入前的延迟,单位秒,运行时量化为逻辑毫秒;与动作自身的等待参数分别配置。 |
| FlowAction.EveryFrame | Boolean | configuration | false | 持续执行选项;例如调用方法会保持逐帧调用。未 Finish 的动作本身仍有 Update,此开关不会强制完成或重复 Enter。 |
| FlowAction.FinishEvent | String | configuration | "" | 本 Action 完成时发送的可选事件;留空不会阻止节点在所有 Action 完成后发送 FINISHED。 |
| FlowAction.FailEvent | String | configuration | "" | 本 Action 失败时的可选事件,连接对应失败处理;打断不等同于成功。 |
输出 / 返回:见执行完成规则
连接与调用示例
Animator 的 Base Layer 创建 Attack 状态并关联动画片段;StateName=Base Layer.Attack、Layer=0、BlendMs=100、DurationMs=600。入口 → 播放人物动画 → FINISHED → 返回。完成时间由逻辑时钟决定,不读取动画归一化时间。
完成与打断
一个节点上的 Action 全部完成才流入下一节点。被打断也会执行 Exit 清理,但不会发送伪成功。毫秒、秒、米和毫米不可混用。