SceneKit角色动画过渡问题：行走时手臂保持T姿

你的问题核心是角色播放行走动画时手臂保持初始T姿，这通常由动画节点绑定错误、骨骼名称不匹配或初始状态未被动画覆盖导致，以下是针对性的修复步骤：

1. 修正角色节点引用 #

你当前直接将动画添加到场景rootNode，但实际动画需要绑定到角色的骨骼根节点，而非整个场景根节点。先找到场景中的角色实际节点：

// 替换原有的model定义
let scene = SCNScene(named: "Agnes.scn")!
// 找到场景中名为"Agnes"的角色节点（根据你的模型实际名称调整）
guard let model = scene.rootNode.childNode(withName: "Agnes", recursively: true) else {
    fatalError("未找到角色节点，请检查模型名称")
}
let speed:TimeInterval = 5
var run:SCNAnimationPlayer?
var dance:SCNAnimationPlayer?
var idle:SCNAnimationPlayer?
var anim:SCNAnimationPlayer?

2. 优化动画加载逻辑 #

确保动画被正确添加到角色节点，并添加错误处理避免崩溃：

func animation(name: String, for targetNode: SCNNode) -> SCNAnimationPlayer? {
    guard let animationScene = SCNScene(named: name) else {
        print("无法加载动画文件：\(name)")
        return nil
    }
    
    var targetPlayer: SCNAnimationPlayer?
    animationScene.rootNode.enumerateChildNodes { childNode, stop in
        guard let firstKey = childNode.animationKeys.first else { return }
        targetPlayer = childNode.animationPlayer(forKey: firstKey)
        stop.pointee = true // 找到第一个动画后停止遍历
    }
    
    guard let player = targetPlayer else {
        print("动画文件中未找到动画轨道：\(name)")
        return nil
    }
    
    // 配置动画过渡属性
    player.animation.isRemovedOnCompletion = false
    player.animation.blendInDuration = speed
    player.animation.blendOutDuration = speed
    player.animation.usesSceneTimeBase = false
    
    // 将动画绑定到角色节点
    targetNode.addAnimationPlayer(player, forKey: name)
    player.stop()
    
    return player
}

3. 初始化时覆盖默认T姿 #

初始状态下直接播放idle动画，替换无动画的T字姿势，确保后续动画切换能完全驱动骨骼：

struct ContentView: View {
    // ... 原有代码不变
    
    var body: some View {
        VStack {
            // ... 原有代码不变
        }
        .onAppear {
            // 传入角色节点加载动画
            run = animation(name: "Running.usdz", for: model)
            dance = animation(name: "Dancing.usdz", for: model)
            idle = animation(name: "Idle.usdz", for: model)
            
            // 初始播放idle动画，覆盖默认T姿
            idle?.play()
            anim = idle
        }
    }
}

4. 检查骨骼名称匹配（关键排查点） #

如果以上修复后手臂仍不动，大概率是动画骨骼与角色骨骼名称不匹配：

• 用Xcode打开Agnes.scn和Running.usdz，在SceneKit编辑器中查看两者的骨骼层级
• 确保角色和动画的骨骼名称完全一致（比如角色的左臂骨骼叫LeftArm，动画中也必须是同名）
• 可以添加调试代码打印角色骨骼名称：

// 在onAppear中添加
model.enumerateChildNodes { node, _ in
    if node.skeleton != nil || node.parent?.skeleton != nil {
        print("骨骼节点名称：\(node.name ?? "无名节点")")
    }
}

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