RealityKit角色骨骼动画异常：剑与盾未随角色动效联动

可能原因与对应解决方案 #

1. 导出USDZ时未正确包含武器的骨骼动画 #

Blender导出时需确保武器的骨骼绑定数据与角色动画一同被导出：

• 将剑、盾的父对象设置为角色的Armature，确认顶点组已正确关联到手部骨骼（可在Blender的「顶点组」面板检查）。
• 导出USDZ时，在导出面板的「Animation」区域：
  • 勾选「Export Animation」和「Bake Animation」
  • 确认「Frame Range」覆盖完整动画时长
  • 勾选「Include Children」，确保角色、武器、骨骼作为整体导出

2. RealityKit动画播放范围未覆盖武器节点 #

当前代码仅播放children[0]的动画，若剑盾是独立子节点，需调整播放逻辑：

private func loadAnimations() {
    // 尝试播放根节点的动画，而非仅子节点
    guard let rootAnimation = self.availableAnimations.first else { return }
    self.playAnimation(rootAnimation.repeat())
}

若武器是角色本体的子Entity，需确保角色的动画资源包含骨骼层级的所有动画轨道——可通过Xcode的USDZ编辑器查看动画是否包含武器绑定骨骼的关键帧。

3. 验证USDZ动画完整性 #

用Xcode打开导出的USDZ文件，进入「Animation」标签页，检查是否存在剑盾绑定骨骼的动画曲线。若不存在，说明Blender导出时未包含该部分动画，需重新调整导出设置。

4. 合并角色与武器为单一Mesh（备选方案） #

若骨骼绑定导出始终有问题，可在Blender中将角色、剑、盾合并为单一Mesh（需确保合并前权重绑定已完成），再导出USDZ，避免多Entity层级导致的动画同步问题。

内容的提问来源于stack exchange，提问作者Valsamis Elmaliotis