PoBDSDocs
简体中文v1.0.0
POBDS / 12

PlayAnimation

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

Entry → Action [PlayAnimation] → FINISHED → Return. Use FAILED for error handling. Enable continuous updates only where needed.

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