ARKit 3D角色头部追踪异常问题求助

我仔细看了你的代码和描述，这个头部追踪的问题主要出在约束逻辑的冲突和焦点节点的更新方式上，咱们一步步拆解修复：

核心问题分析 #

1. SCNTransformConstraint的错误逻辑：你在TransformConstraint里强制把eulerAngles.y设为0，这直接抵消了SCNLookAtConstraint生成的y轴旋转（左右转头），所以加了这个约束后头部就不再追踪镜头的左右移动了。
2. 焦点节点的延迟更新：用DispatchQueue.main.asyncAfter加延迟动画移动焦点节点，会导致头部追踪滞后，而且平移相机时，焦点节点的位置转换逻辑可能没有正确匹配相机的视角，引发头部侧偏。
3. 约束顺序与冲突：当SCNLookAtConstraint和SCNTransformConstraint同时作用时，后者的修改会覆盖前者的结果，导致预期外的旋转。

修复方案 #

我们换一种更简洁的思路：用SCNLookAtConstraint让头部看向焦点节点，通过限制焦点节点的移动范围来控制头部的旋转角度，去掉容易冲突的SCNTransformConstraint，同时实时更新焦点节点的位置，保证追踪的准确性。

修改后的代码 #

class Daisy: SCNScene, ARCharacter, CAAnimationDelegate {
    // Rig for animation
    private var contentRootNode: SCNNode! = SCNNode()
    private var geometryRoot: SCNNode!
    private var head: SCNNode!
    private var leftEye: SCNNode!
    private var rightEye: SCNNode!
    
    // Head tracking properties
    private var focusOfTheHead = SCNNode()
    // 调整基础位置，让头部初始朝向更自然
    private let focusNodeBasePosition = simd_float3(0, 0.1, 0.3)
    // 限制焦点节点的移动范围，对应头部的旋转极限
    private let focusNodeXRange = -0.2...0.2
    private let focusNodeYRange = 0.05...0.15
    
    // State properties
    private var modelLoaded: Bool = false
    private var shouldTrackCamera: Bool = false
    
    /*
     * MARK: - Init methods
     */
    override init() {
        super.init()
        loadModel()
        setupSpecialNodes()
        setupConstraints()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    /*
     * MARK: - Setup methods
     */
    func loadModel() {
        guard let virtualObjectScene = SCNScene(named: "daisy_3.dae", inDirectory: "art.scnassets") else {
            print("virtualObjectScene not initialised")
            return
        }
        let wrapper = SCNNode()
        for child in virtualObjectScene.rootNode.childNodes {
            wrapper.addChildNode(child)
        }
        contentRootNode.addChildNode(wrapper)
        self.rootNode.addChildNode(contentRootNode)
        hide()
        modelLoaded = true
    }
    
    private func setupSpecialNodes() {
        // 确保从contentRootNode下查找，避免层级错误
        geometryRoot = contentRootNode.childNode(withName: "D_Rig", recursively: true)
        head = contentRootNode.childNode(withName: "D_RigFBXASC032Head", recursively: true)
        leftEye = contentRootNode.childNode(withName: "D_Eye_L", recursively: true)
        rightEye = contentRootNode.childNode(withName: "D_Eye_R", recursively: true)
        
        // 焦点节点挂载到geometryRoot，保证坐标空间一致
        focusOfTheHead.simdPosition = focusNodeBasePosition
        geometryRoot?.addChildNode(focusOfTheHead)
    }
    
    /*
     * MARK: - Head animations
     */
    func updateForScene(_ scene: ARSCNView) {
        guard shouldTrackCamera, let pointOfView = scene.pointOfView, let geometryRoot = geometryRoot else {
            print("Not going to updateForScene")
            return
        }
        // 实时更新焦点节点，去掉延迟动画
        updateFocusNode(to: pointOfView, relativeTo: geometryRoot)
    }
    
    private func updateFocusNode(to pov: SCNNode, relativeTo rootNode: SCNNode) {
        // 将相机的世界位置转换为角色根节点的局部坐标
        let cameraLocalPos = rootNode.convertPosition(pov.worldPosition, from: nil)
        // 计算焦点节点的目标位置：保持z轴固定（模拟头部向前看的距离），x/y跟随相机的局部位置
        var targetX = cameraLocalPos.x
        var targetY = cameraLocalPos.y
        var targetZ = focusNodeBasePosition.z
        
        // 限制x/y在允许范围内，避免头部旋转过度
        targetX = min(max(targetX, focusNodeXRange.lowerBound), focusNodeXRange.upperBound)
        targetY = min(max(targetY, focusNodeYRange.lowerBound), focusNodeYRange.upperBound)
        
        // 直接更新焦点节点位置，不需要动画（如果需要平滑，可以用SCNTransaction做淡入）
        focusOfTheHead.position = SCNVector3(targetX, targetY, targetZ)
    }
    
    private func setupConstraints() {
        guard let head = head else { return }
        
        // 只保留LookAtConstraint，启用GimbalLock避免不必要的旋转
        let headLookConstraint = SCNLookAtConstraint(target: focusOfTheHead)
        headLookConstraint.isGimbalLockEnabled = true
        // 允许约束影响所有轴，这样头部可以左右/上下转动
        headLookConstraint.constraintAxes = .all
        
        // 移除冲突的TransformConstraint，用焦点节点的位置限制替代旋转限制
        head.constraints = [headLookConstraint]
    }
    
    // Helper to convert degrees to radians（如果后续需要可以保留）
    private func rad(_ deg: Float) -> Float {
        return deg * Float.pi / 180
    }
    
    // 补充hide方法（原代码中调用了但没实现）
    private func hide() {
        contentRootNode.isHidden = true
    }
}

关键修改点说明 #

1. 移除冲突的TransformConstraint：不再手动修改头部的欧拉角，而是通过限制焦点节点的x/y位置来控制头部的旋转范围，这样既避免了约束冲突，逻辑也更直观。
2. 实时更新焦点节点：去掉延迟动画，在updateForScene中同步计算相机的局部位置，直接更新焦点节点，保证追踪的实时性和准确性。
3. 修正节点查找层级：从contentRootNode下查找角色的骨骼节点，避免因为根节点层级问题导致的坐标转换错误。
4. 调整焦点节点的范围限制：通过focusNodeXRange和focusNodeYRange可以灵活控制头部左右/上下转动的最大角度，你可以根据角色模型的实际情况调整数值。

额外建议 #

• 如果你想要头部移动更平滑，可以在更新焦点节点位置时，用SCNTransaction添加一个短时间的动画，比如：

  SCNTransaction.begin()
  SCNTransaction.animationDuration = 0.15
  focusOfTheHead.position = SCNVector3(targetX, targetY, targetZ)
  SCNTransaction.commit()
  

• 测试时可以给focusOfTheHead添加一个可视化的几何体（比如小球体），方便观察焦点节点的位置是否正确，调试完成后再隐藏它。

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