AR场景中SCNNode无法添加至rootNode，3D对象位置异常

问题描述 #

点击按钮在AR场景中添加3D对象，预期对象生成在相机当前位置，但实际对象虽能正常显示和旋转，却始终出现在(0,0,0)坐标，多次点击生成的对象重叠于此。排查发现SCNNode未成功添加至rootNode（返回nil），尝试开启/关闭水平平面检测、硬编码SCNVector3等方案均无效。

开发环境：Xcode 15.2，测试设备为iPhone SE（第二代）及部分模拟器。

原代码 #

override func viewDidLoad() {
    super.viewDidLoad()
    
    // Set the View Controller as the AR Scene delegate
    sceneView.delegate = self
    
    sceneView.autoenablesDefaultLighting = true
}

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    
    // Create a session configuration
    let configuration = ARWorldTrackingConfiguration()
    
    //configuration.planeDetection = [.horizontal]
    
    // Run the view's session
    sceneView.session.run(configuration)
    
}

@IBAction func DropTokenPressed(_ sender: Any) {
    
    if let cameraPosition = sceneView.pointOfView?.position {
          //debug text - show coordinates on screen            
          tempText.text = "x: \(cameraPosition.x)\ny: \(cameraPosition.y)\n              z: \(cameraPosition.z)"
          let scene = SCNScene(named: "art.scnassets/Been_Token_v2.scn")!
          if let sceneNode = scene.rootNode.childNode(withName: "token", recursively: true){
              sceneNode.position = cameraPosition
              print(sceneNode)
              sceneView.scene.rootNode.addChildNode(sceneNode)
          }
      }
}

修复方案 #

核心问题分析 #

1. 节点所有权冲突：直接从加载的SCNScene中获取节点并添加到AR场景，该节点仍被原场景持有，导致坐标系解析异常，无法正确定位。
2. 坐标系错误：sceneView.pointOfView?.position是相机的局部坐标（相对于其父节点），并非AR世界的全局坐标，直接赋值会导致位置偏移到原点。

修复后的代码 #

@IBAction func DropTokenPressed(_ sender: Any) {
    // 确保相机节点存在
    guard let cameraNode = sceneView.pointOfView else { return }
    
    // 将相机的局部原点转换为世界坐标系位置（即相机在AR世界中的真实位置）
    let worldCameraPosition = cameraNode.convertPosition(SCNVector3Zero, to: nil)
    
    // 更新调试文本
    tempText.text = "x: \(worldCameraPosition.x)\ny: \(worldCameraPosition.y)\nz: \(worldCameraPosition.z)"
    
    // 加载场景并克隆节点（避免原场景的引用干扰）
    guard let tokenScene = SCNScene(named: "art.scnassets/Been_Token_v2.scn"),
          let originalTokenNode = tokenScene.rootNode.childNode(withName: "token", recursively: true),
          let clonedTokenNode = originalTokenNode.clone() else {
        print("无法加载或克隆token节点")
        return
    }
    
    // 设置节点在世界坐标系的位置
    clonedTokenNode.position = worldCameraPosition
    // 可选：让节点朝向与相机一致，避免对象倒置
    clonedTokenNode.eulerAngles = cameraNode.eulerAngles
    
    // 添加到AR场景的根节点
    sceneView.scene.rootNode.addChildNode(clonedTokenNode)
}

额外提示 #

• 优先使用真实设备测试：ARKit模拟器的相机位置模拟存在误差，真实设备能更准确反映AR场景的坐标逻辑。
• 验证节点命名：确认.scn文件中目标节点的名称确实为token，拼写错误会导致节点获取失败。
• 平面检测不影响此问题：开启或关闭水平平面检测与节点定位无关，无需调整该配置。

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