动画组件

下面每个字段都由引擎自身的组件注册表推导而来——就是编辑器 Details 面板读的那一份—— 所以这里的类型和默认值就是你添加组件时真正拿到的值，且不可能与代码脱节。讲怎么用的正文在每条目所链接的指南里。字段说明取自 C++ ES_PROPERTY 处的原文，因此为英文。

`Animator`

Runs an animator controller — states, transitions and blend trees — over the entity.

Field	Type	Default
`controller`	`Asset<animatorcontroller>`	`none`
`currentState`	`string`	`empty`
`enabled`	`boolean`	`true`

A DragonBones armature: its skeleton and atlas assets, armature choice and playback state.

Field	Type	Default	Notes
`skeletonPath`	`string`	`empty`
`atlasPath`	`string`	`empty`
`armature`	`enum (dragonbonesArmatures)`	`empty`
`animation`	`enum (dragonbonesAnimations)`	`empty`
`timeScale`	`number`	`1`	Range ≥ 0.
`loop`	`boolean`	`true`
`playing`	`boolean`	`true`
`fadeInTime`	`number`	`0`	Range ≥ 0, step 0.05.
`flipX`	`boolean`	`false`
`flipY`	`boolean`	`false`
`color`	`Color`	`#ffffff`
`layer`	`enum (sortingLayers)`	`0`	Range step 1.
`skeletonScale`	`number`	`1`	Range ≥ 0.
`material`	`Asset<material>`	`none`
`enabled`	`boolean`	`true`

A Spine skeleton: its skeleton and atlas assets, current animation, skin and mix settings.

Field	Type	Default	Notes
`skeletonPath`	`string`	`empty`
`atlasPath`	`string`	`empty`
`skin`	`enum (spineSkins)`	`empty`
`animation`	`enum (spineAnimations)`	`empty`
`timeScale`	`number`	`1`	Range ≥ 0.
`loop`	`boolean`	`true`
`playing`	`boolean`	`true`
`flipX`	`boolean`	`false`
`flipY`	`boolean`	`false`
`color`	`Color`	`#ffffff`
`layer`	`enum (sortingLayers)`	`0`	Range step 1.
`skeletonScale`	`number`	`1`	Range ≥ 0.
`material`	`Asset<material>`	`none`
`enabled`	`boolean`	`true`

Plays a flipbook clip by swapping the sprite frame, with speed, looping and frame events.

Field	Type	Default
`clip`	`Asset<anim-clip>`	`none`
`speed`	`number`	`1`
`playing`	`boolean`	`true`
`loop`	`boolean`	`true`
`enabled`	`boolean`	`true`
`currentFrame`	`number`	`0`
`frameTimer`	`number`	`0`
`finished`	`boolean`	`false`

Plays a timeline asset — keyframed tracks across many entities — with wrap modes and playback control.

Field	Type	Default	Notes
`timeline`	`Asset<timeline>`	`none`
`playing`	`boolean`	`false`
`speed`	`number`	`1`
`wrapMode`	`string`	`"once"`
`finished`	`boolean`	`false`	Clip completed (runtime, read-only). Raise Playing to replay.