视图手势操作后centerCameraOnDot相机动画失效问题求助

我开发了一个基础的3D交互式地球仪，使用centerCameraOnDot函数将相机定位到地球仪的不同区域。初始调用该函数时一切运行顺畅，连续多次调用不同位置也能正确完成动画切换。

但如果先对视图执行任意手势操作，等待几秒后再调用该函数，相机将不会执行动画切换。经调试确认，函数正常执行且newCameraPosition计算正确，但相机动作未生效，推测是手势修改了场景/相机的状态。

尝试重新初始化视图虽能解决问题，但并不实用。请问如何忽略之前的手势操作，确保相机动画正常执行？

附核心代码片段：

func centerCameraOnDot(dotPosition: SCNVector3) {
    let fixedDistance: Float = 6.0
    let newCameraPosition = dotPosition.normalized().scaled(to: fixedDistance)

    // Position animation
    let moveAction = SCNAction.move(to: newCameraPosition, duration: 1.5)

    // Set up lookAt constraint for orientation
    let constraint = SCNLookAtConstraint(target: earthNode)
    constraint.isGimbalLockEnabled = true

    // Animate the transition
    SCNTransaction.begin()
    SCNTransaction.animationDuration = 1.5

    cameraNode.constraints = [constraint]
    cameraNode.runAction(moveAction)

    SCNTransaction.commit()
}

问题根源在于开启sceneView.allowsCameraControl = true后，SceneKit会创建内置相机控制器接管相机的状态管理，包括位置、约束和动画。用户手势操作后，该控制器会锁定相机状态，导致手动添加的动画被覆盖或忽略。

以下是具体解决步骤：

1. 临时禁用用户相机控制 #

执行相机动画前关闭用户控制权，动画完成后再恢复，避免内置控制器干扰：

func centerCameraOnDot(dotPosition: SCNVector3) {
    // 临时禁用相机控制
    sceneView.allowsCameraControl = false
    
    let fixedDistance: Float = 6.0
    let newCameraPosition = dotPosition.normalized().scaled(to: fixedDistance)

    let moveAction = SCNAction.move(to: newCameraPosition, duration: 1.5)
    // 动画完成后恢复相机控制
    let restoreControlAction = SCNAction.run { _ in
        self.sceneView.allowsCameraControl = true
    }
    let sequence = SCNAction.sequence([moveAction, restoreControlAction])

    let constraint = SCNLookAtConstraint(target: earthNode)
    constraint.isGimbalLockEnabled = true

    SCNTransaction.begin()
    SCNTransaction.animationDuration = 1.5

    // 清除之前的约束和动作，重置相机状态
    cameraNode.removeAllActions()
    cameraNode.constraints = []
    
    cameraNode.constraints = [constraint]
    cameraNode.runAction(sequence)

    SCNTransaction.commit()
}

2. 强制绑定相机节点所有权 #

确保SceneKit始终使用你定义的相机节点，避免内置控制器替换节点：

private func setupCamera() {
    self.cameraNode = SCNNode()
    cameraNode.camera = SCNCamera()
    cameraNode.position = SCNVector3(x: 0, y: 0, z: 5)
    sceneView.scene?.rootNode.addChildNode(cameraNode)
    // 强制指定当前相机为场景活动相机
    sceneView.pointOfView = cameraNode
}

3. 重置相机状态 #

在动画开始前主动清除所有现存动作和约束，彻底清除手势操作留下的状态：

// 在设置新约束和动作前执行
cameraNode.removeAllActions()
cameraNode.constraints?.removeAll()

当allowsCameraControl开启时，用户第一次手势操作后，SceneKit会将sceneView.pointOfView替换为它自己管理的相机副本，此时你定义的cameraNode不再是场景实际使用的相机。通过手动绑定pointOfView并临时禁用相机控制，可以强制恢复自定义相机的控制权，避免内置控制器干扰动画执行。

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