PoBDS文档
Englishv1.0.0
POBDS / 12

播放人物动画

在角色对象或子物体上挂载 Animator,并配置 Controller。填写状态名、层索引和过渡时间,用逻辑毫秒配置完成时机。缺少 Animator、Controller 或状态时会失败并给出原因。

关键配置

该 API 对应的实际编辑器节点 / 参数面板,点击查看原尺寸。

参数与引脚

参数名类型方向默认值说明
StateNameStringconfiguration"Idle"Animator 状态名或完整路径,例如 Base Layer.Attack;不是动画文件名。
DurationMsInt32configuration0持续毫秒数;整数模拟时间。
BlendMsInt32configuration100动画过渡时长,单位毫秒;0 表示立即播放。
LayerInt32configuration0Animator 层索引,从 0 开始;状态必须存在于所选层。
FlowAction.DelayFloat (s)configuration0此动作进入前的延迟,单位秒,运行时量化为逻辑毫秒;与动作自身的等待参数分别配置。
FlowAction.EveryFrameBooleanconfigurationfalse持续执行选项;例如调用方法会保持逐帧调用。未 Finish 的动作本身仍有 Update,此开关不会强制完成或重复 Enter。
FlowAction.FinishEventStringconfiguration""本 Action 完成时发送的可选事件;留空不会阻止节点在所有 Action 完成后发送 FINISHED。
FlowAction.FailEventStringconfiguration""本 Action 失败时的可选事件,连接对应失败处理;打断不等同于成功。

输出 / 返回:见执行完成规则

连接与调用示例

Animator 的 Base Layer 创建 Attack 状态并关联动画片段;StateName=Base Layer.Attack、Layer=0、BlendMs=100、DurationMs=600。入口 → 播放人物动画 → FINISHED → 返回。完成时间由逻辑时钟决定,不读取动画归一化时间。

完成与打断

一个节点上的 Action 全部完成才流入下一节点。被打断也会执行 Exit 清理,但不会发送伪成功。毫秒、秒、米和毫米不可混用。

支持多个关键词与 / 路径组合 · Enter 打开第一项 · Esc 关闭