findSkeletonRootEntity

@MainThread
fun findSkeletonRootEntity(includeDisabled: Boolean = false): Array<Entity>

Finds all skeleton root entities that can serve as Skin Animation playback entry points within this entity and its children. The search traverses the entire entity hierarchy starting from the current entity.

Unlike findSkinnedMeshEntity, which targets skinned-mesh rendering nodes, this API targets the root entity of each skeleton, which is the recommended target for playAnimation.

Return

An array of skeleton root entities; empty array if none are found.

Parameters

includeDisabled

Whether to include disabled entities in the search.

  • true: returns both enabled and disabled skeleton root entities.

  • false: returns only enabled entities.