如何在RealityKit框架中合并两个骨骼动画？

阿华AIGC实验室

2026-4-7

我太懂这种感受了——WWDC那期讲RealityKit动画的session确实有点绕，尤其是混合多个骨骼动画这块，刚接触的时候真的容易懵。你试的那段代码方向是对的，但还差几个关键细节没做到位，我来给你捋明白。

首先得明确一个核心前提：要让两个动画同时生效，它们必须只作用于互不重叠的骨骼组——比如你说的一个管手臂、一个管腿，绝对不能让两个动画都控制全身骨骼，不然它们会在相同骨骼上产生冲突，最后只有一个能生效。

接下来是你没注意到的关键步骤：给动画设置骨骼掩码（Skeleton Mask），这是实现动画分层混合的核心。它的作用是限制动画只对指定的骨骼子集生效，这样两个动画在不同混合层播放时就不会互相干扰。

话不多说，直接上可落地的代码调整方案：

先加载你的两个动画资源（这里假设你的角色是character实体，已经带有骨骼组件）：

guard let armAnimation = try? Entity.loadAnimation(named: "ArmAnimation"),
      let legAnimation = try? Entity.loadAnimation(named: "LegAnimation") else {
    print("动画资源加载失败")
    return
}

为每个动画创建对应的骨骼掩码，精准限制它们的作用范围：

// 先获取角色的骨骼组件，确保存在
guard let skeleton = character.skeleton else {
    print("角色没有骨骼组件")
    return
}

// 手臂动画的掩码：只包含上肢相关骨骼路径（根据你的3D模型骨骼命名调整）
let armSkeletonMask = SkeletonMask(skeleton, paths: [
    "Hips->Spine->Spine1->RightShoulder->RightArm->RightForeArm->RightHand",
    "Hips->Spine->Spine1->LeftShoulder->LeftArm->LeftForeArm->LeftHand"
])

// 腿部动画的掩码：只包含下肢相关骨骼路径
let legSkeletonMask = SkeletonMask(skeleton, paths: [
    "Hips->RightUpLeg->RightLeg->RightFoot->RightToeBase",
    "Hips->LeftUpLeg->LeftLeg->LeftFoot->LeftToeBase"
])

这里的骨骼路径要和你的3D模型里的骨骼命名完全对应，你可以在ModelIO或者3D建模软件里查看模型的骨骼层级结构。

把掩码应用到动画上，生成带约束的动画实例：

let maskedArmAnim = armAnimation.masked(with: armSkeletonMask)
let maskedLegAnim = legAnimation.masked(with: legSkeletonMask)

最后在不同的混合层播放这两个动画：

// 手臂动画放在混合层0
character.playAnimation(maskedArmAnim.repeat(), blendLayerOffset: 0)
// 腿部动画放在混合层1
character.playAnimation(maskedLegAnim.repeat(), blendLayerOffset: 1)

这样操作之后，你就能看到角色的手臂和腿部同时播放各自的动画了。

另外再提个小坑：如果你发现动画还是有冲突，记得检查两个掩码的骨骼路径有没有重叠，比如别不小心让手臂动画也包含了髋骨——那腿部动画的髋骨控制就会被覆盖。

内容来源于stack exchange