configure-animation

动画设置

通过 inspect-glb 获取片段和关节名称；切勿猜测。

• 单个片段使用表面的简单播放路径。对于混合、过渡或事件，请使用 find-examples 改编官方动画示例中的 AnimStateGraph。
• 将 anim 组件放在已渲染的蒙皮层级上或其上方，不要放在单独的枢轴上。
• 将每个一维混合参数限制在其首尾子点范围内。Engine 不会这样做；超出范围的值会使所有权重归零，并可能导致同步速度变为非有限值，从而冻结姿势。
• 仅当每个源 animationTargets 路径去掉其 .translation、.rotation、.scale 或 .weights 后缀后，与模型根节点下的目标 nodePaths 条目匹配时，才进行重定向。关节数量相同或名称相似都不够。
• 缩放包装节点，绝不要缩放蒙皮骨骼。

验证播放

状态处于活动状态或状态时间不断推进，并不能证明动画正在播放。在多个已渲染帧中（使用 inspect-runtime），对两个非根关节进行采样，检查静止时以及每个混合树两端的情况。关节没有运动就意味着绑定、播放或混合权重存在问题。

诊断

• T 姿势：未指定片段、目标路径不同，或 anim 组件位于已渲染层级之外。
• 姿势冻结：混合输入未限制范围，或速度为非有限值。
• 运动不完整或姿势爆炸：骨架不兼容。

只阅读与代码相匹配的参考文档：direct Engine、 React 或 Web Components。