如何修复SCNNode旋转超90度时的异常转向？需保持X/Z轴平行地面并朝向相机

我尝试让一个SCNNode始终处于相机前方1米位置，同时确保该节点的X轴与Z轴始终平行于地面，仅绕Y轴旋转以始终朝向相机。以下代码基本实现了需求，但当顺时针或逆时针旋转超过90°时，节点会出现异常转向，请问该如何修复？

override func viewDidLoad() { 
    super.viewDidLoad() 
    boxParent.position = (sceneView.pointOfView?.position)! 
    boxParent.orientation = (sceneView.pointOfView?.orientation)! 
    boxParent.eulerAngles = (sceneView.pointOfView?.eulerAngles)! 
    sceneView.scene.rootNode.addChildNode(boxParent) 
    boxOrigin.position = SCNVector3(0,0,-1) 
    boxParent.addChildNode(boxOrigin) 
    box = SCNNode(geometry: SCNBox(width: 0.5, height: 0.2, length: 0.3, chamferRadius: 0)) 
    box.geometry?.firstMaterial?.diffuse.contents = UIColor.blue 
    box.position = SCNVector3(0,0,0) 
    boxOrigin.addChildNode(box) 
} 

func renderer(_ renderer: SCNSceneRenderer, updateAtTime time: TimeInterval) { 
    boxParent.eulerAngles = (sceneView.pointOfView?.eulerAngles)! 
    boxParent.orientation = (sceneView.pointOfView?.orientation)! 
    boxParent.position = (sceneView.pointOfView?.position)! 
    box.position = boxOrigin.worldPosition 
    box.eulerAngles.y = (sceneView.pointOfView?.eulerAngles.y)! 
    print(box.eulerAngles) 
    sceneView.scene.rootNode.addChildNode(box) 
} 

先给你指出代码里的几个明显问题，这些是导致异常的直接原因：

1. 重复添加节点：在updateAtTime里每次都调用sceneView.scene.rootNode.addChildNode(box)，这会让box被反复加到根节点，不仅浪费资源，还会导致节点层级混乱，直接删掉这行就行。
2. 欧拉角直接赋值的坑：直接把相机的Y轴欧拉角赋值给box，会因为欧拉角的“万向锁”特性或者角度值的跳变（比如从π/2突然跳到-π/2），导致相机转超过90度时节点突然反向。

正确的思路是：通过计算节点到相机的水平方向向量，生成对应的旋转四元数，这样既能保证box始终朝向相机，又能维持X、Z轴平行地面，还能避免欧拉角的问题。

修复后的代码示例 #

override func viewDidLoad() { 
    super.viewDidLoad() 
    // 初始化boxParent作为相机的跟随节点
    boxParent = SCNNode()
    sceneView.scene.rootNode.addChildNode(boxParent) 
    // boxOrigin放在相机前方1米处（相对于boxParent的局部坐标系）
    boxOrigin.position = SCNVector3(0, 0, -1) 
    boxParent.addChildNode(boxOrigin) 
    // 创建box节点
    box = SCNNode(geometry: SCNBox(width: 0.5, height: 0.2, length: 0.3, chamferRadius: 0)) 
    box.geometry?.firstMaterial?.diffuse.contents = UIColor.blue 
    boxOrigin.addChildNode(box) 
} 

func renderer(_ renderer: SCNSceneRenderer, updateAtTime time: TimeInterval) { 
    guard let camera = sceneView.pointOfView else { return }
    
    // 更新boxParent的位置为相机位置
    boxParent.position = camera.position
    
    // 保持boxParent的X、Z轴平行地面，只继承相机的Y轴旋转
    let cameraYAngle = camera.eulerAngles.y
    boxParent.eulerAngles = SCNVector3(0, cameraYAngle, 0)
    
    // 计算相机到box的水平方向向量（忽略Y轴，保证节点水平朝向）
    let direction = SCNVector3(
        camera.position.x - box.worldPosition.x,
        0,
        camera.position.z - box.worldPosition.z
    )
    
    // 将方向向量转换为旋转四元数，只绕Y轴旋转
    let lookAtRotation = SCNQuaternionLookAt(direction, up: SCNVector3(0, 1, 0))
    box.orientation = lookAtRotation
}

// 辅助函数：根据方向向量和上方向生成四元数
func SCNQuaternionLookAt(_ direction: SCNVector3, up: SCNVector3) -> SCNQuaternion {
    let normalizedDirection = direction.normalized()
    let right = up.cross(normalizedDirection).normalized()
    let correctedUp = normalizedDirection.cross(right).normalized()
    
    let m00 = right.x; let m01 = right.y; let m02 = right.z
    let m10 = correctedUp.x; let m11 = correctedUp.y; let m12 = correctedUp.z
    let m20 = normalizedDirection.x; let m21 = normalizedDirection.y; let m22 = normalizedDirection.z
    
    let trace = m00 + m11 + m22
    var qw, qx, qy, qz: Float
    
    if trace > 0 {
        let s = sqrt(trace + 1.0)
        qw = s * 0.5
        let invS = 1.0 / s
        qx = (m12 - m21) * invS
        qy = (m20 - m02) * invS
        qz = (m01 - m10) * invS
    } else if (m00 >= m11) && (m00 >= m22) {
        let s = sqrt(1.0 + m00 - m11 - m22)
        let invS = 1.0 / s
        qx = 0.5 * s
        qy = (m01 + m10) * invS
        qz = (m02 + m20) * invS
        qw = (m12 - m21) * invS
    } else if m11 > m22 {
        let s = sqrt(1.0 + m11 - m00 - m22)
        let invS = 1.0 / s
        qy = 0.5 * s
        qx = (m01 + m10) * invS
        qz = (m12 + m21) * invS
        qw = (m20 - m02) * invS
    } else {
        let s = sqrt(1.0 + m22 - m00 - m11)
        let invS = 1.0 / s
        qz = 0.5 * s
        qx = (m02 + m20) * invS
        qy = (m12 + m21) * invS
        qw = (m01 - m10) * invS
    }
    
    return SCNQuaternion(x: qx, y: qy, z: qz, w: qw)
}

// 扩展SCNVector3添加归一化和叉乘方法
extension SCNVector3 {
    func normalized() -> SCNVector3 {
        let length = sqrt(x*x + y*y + z*z)
        return SCNVector3(x/length, y/length, z/length)
    }
    
    func cross(_ vector: SCNVector3) -> SCNVector3 {
        return SCNVector3(
            y * vector.z - z * vector.y,
            z * vector.x - x * vector.z,
            x * vector.y - y * vector.x
        )
    }
}

关键修复点说明 #

• 移除重复添加节点：删掉updateAtTime里的重复添加代码，box已经是boxOrigin的子节点，无需重复加入根节点。
• 用方向向量计算朝向：通过相机与box的水平方向向量生成旋转四元数，彻底避免欧拉角带来的翻转问题，保证相机任意旋转时，box都能平滑绕Y轴朝向相机。
• 维持水平姿态：boxParent只继承相机的Y轴旋转，确保boxOrigin始终在相机正前方1米且保持水平，不会随相机俯仰或翻滚而倾斜。

内容的提问来源于stack exchange，提问作者Gene M.