<Anim/>
Anim 为实体播放动画资源,并控制播放状态。
用法
import { Entity } from '@playcanvas/react'
import { Anim, Render } from '@playcanvas/react/components'
import { useModel } from '@playcanvas/react/hooks'
const AnimatingDinosaur = (props) => {
const { asset } = useModel('/dinosaur.glb')
if (!asset) return null
return (
<Entity {...props}>
<Render type="asset" asset={asset} />
<Anim asset={asset} playing />
</Entity>
)
}
传入资源时,会将其全部动画分配到同一状态,多段时仅最后一段播放。按名称播放、状态图、图层和事件详见动画。
始终显式传 playing。每次渲染都会将全部 props 重新写入引擎,默认 playing=false,不指定时组件再次渲染就停止动画。
详见引擎 AnimComponent。
属性
| 名称 | 类型与说明 | 默认值 |
|---|---|---|
asset | Asset<string>包含待播放动画的资源。设置此属性会自动将其中的动画分配给组件。 | - |
stateGraphAsset? | any | - |
normalizeWeights? | boolean设置或获取是否按各层权重总和归一化动画层权重。 | - |
animationAssets? | {} | - |
speed? | number设置或获取动画播放速度倍率。1.0 为正常速度,0.0 为暂停。 | - |
activate? | boolean设置或获取场景加载后是否自动播放第一段动画。 | - |
playing? | boolean设置或获取组件中所有动画的播放或暂停状态。 | - |
rootBone? | Entity设置或获取动画层级的根实体。 | - |
stateGraph? | any | - |
layerIndices? | {} | - |
parameters? | {} | - |
targets? | {} | - |
system? | ComponentSystem创建此组件的 ComponentSystem。 | - |
entity? | Entity此组件挂载的 Entity。 | - |
enabled? | boolean设置或获取组件的启用状态。 | - |