SwiftUI中SceneKit相机用户交互后无法重定位的解决方法

问题根源 #

当设置scnView.allowsCameraControl = true时，SceneKit会自动创建SCNCameraController实例，并将你手动创建的cameraNode重新挂载为该控制器内部节点的子节点。此时直接修改原cameraNode的位置或变换，会被相机控制器的内部状态覆盖，导致按钮触发的定位操作失效。

解决方案 #

绕过原cameraNode，直接操纵SceneKit自动创建的相机控制器视角节点，强制重置相机状态。以下是修改后的完整代码：

struct SceneKitView: UIViewRepresentable {
    @Binding var isCameraInside: Bool
    
    class Coordinator: NSObject {
        var cameraController: SCNCameraController?
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator()
    }
    
    func makeUIView(context: Context) -> SCNView {
        let scnView = SCNView()
        let scene = SCNScene()
        scnView.scene = scene
        
        // 创建球体
        let sphere = SCNSphere(radius: 1.0)
        let material = SCNMaterial()
        material.diffuse.contents = UIColor.black
        material.isDoubleSided = true
        sphere.materials = [material]
        let sphereNode = SCNNode(geometry: sphere)
        sphereNode.geometry?.firstMaterial?.fillMode = .lines
        scene.rootNode.addChildNode(sphereNode)
        
        // 创建相机节点
        let camera = SCNCamera()
        let cameraNode = SCNNode()
        cameraNode.camera = camera
        cameraNode.position = SCNVector3(x: 0, y: 0, z: 5)
        scene.rootNode.addChildNode(cameraNode)
        
        scnView.allowsCameraControl = true
        scnView.backgroundColor = .white
        
        // 保存相机控制器引用
        context.coordinator.cameraController = scnView.cameraController
        
        return scnView
    }
    
    func updateUIView(_ uiView: SCNView, context: Context) {
        guard let cameraController = context.coordinator.cameraController,
              let pointOfView = cameraController.pointOfView else { return }
        
        // 临时禁用相机控制，避免动画被手势干扰
        uiView.allowsCameraControl = false
        
        SCNTransaction.begin()
        SCNTransaction.animationDuration = 0.5
        
        // 重置相机姿态并设置目标位置
        pointOfView.transform = SCNMatrix4Identity
        pointOfView.position = isCameraInside ? SCNVector3(x: 0, y: 0, z: 0) : SCNVector3(x: 0, y: 0, z: 5)
        
        SCNTransaction.completionBlock = {
            // 动画完成后恢复相机控制
            DispatchQueue.main.async {
                uiView.allowsCameraControl = true
            }
        }
        
        SCNTransaction.commit()
    }
}

关键修改点 #

1. 直接操纵控制器视角节点：通过cameraController.pointOfView获取被控制器管理的实际相机节点，修改该节点的变换和位置，避免被控制器内部状态覆盖。
2. 移除冗余的渲染代理：取消原renderer(_:updateAtTime:)的频繁状态标记，改为每次按钮触发时直接重置相机，无需额外判断。
3. 优化控制时机：动画完成后立即恢复相机控制，无需额外延迟（SCNTransaction的完成回调会在动画结束后立即执行）。

额外优化建议 #

若需要精准检测用户手动操作，可以监听SCNCameraController的cameraControlState属性变化，或为sceneView的手势识别器添加代理，在手势触发时标记用户交互状态。

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