PoBDSDocs
简体中文v1.0.0
POBDS / 12

Play Animation

Attach an Animator with a controller to the Actor object or a child. Enter the state name and layer, choose the blend duration and configure completion using simulation milliseconds. Missing Animator, controller or state fails the Action with a diagnostic.

Configuration

Actual editor node / inspector for this API. Click to inspect full resolution.

Parameters and pins

NameTypeDirectionDefaultMeaning
AnimationNameStringconfiguration""Required. Animator state name or full path; this field does not take an AnimationClip asset.
CrossFadeTimeSingleconfiguration0.1Blend duration in seconds; zero plays immediately.
WaitForCompleteBooleanconfigurationFalseWait for the internal operation before finishing this Action.
DurationMsInt32configuration0Duration in integer simulation milliseconds.
LayerInt32configuration0Zero-based Animator layer index; the state must exist on that layer.
FlowAction.DelayFloat (s)configuration0Delay before entering this Action, in seconds quantized to simulation milliseconds; separate from an Action-specific wait duration.
FlowAction.EveryFrameBooleanconfigurationfalseContinuous execution option; for example, keep invoking a method each frame. Unfinished Actions still receive Update; this does not force completion or repeat Enter.
FlowAction.FinishEventStringconfiguration""Optional event when this Action finishes; empty does not prevent the node from emitting FINISHED once every Action completes.
FlowAction.FailEventStringconfiguration""Optional failure event for this Action; connect error handling as needed. Interruption is not success.

Output / result: See execution completion rules

Example

AnimationName=Base Layer.Attack, Layer=0, CrossFadeTime=0.1, WaitForComplete=true, DurationMs=600. Without waiting, finish after starting playback; waiting requires a positive simulation duration.

Completion and interruption

An Action node advances when all Actions finish. Exit also runs on interruption, but interruption does not emit a false success. Milliseconds, seconds and world units are not interchangeable.

Combine keywords with / · Enter opens first result · Esc closes