ARKit 1.5重置会话时文本几何节点未移除仅移位的问题

嘿，这个问题我之前也踩过坑！核心原因是重置会话时你没主动清理已创建的文本节点——点击返回按钮时ViewController会被销毁，所有节点自然跟着释放，但重置按钮只是重启ARKit的追踪逻辑，之前添加到场景里的节点还留在场景树中，所以看起来像是“移位”到了新场景中心附近。下面给你两种靠谱的解决办法：

方法一：绑定文本节点到图像锚点节点（自动移除） #

如果把文本节点作为图像锚点对应节点的子节点添加，那只要重置会话时带上.removeExistingAnchors选项，ARKit会自动移除所有旧锚点，连带它的子节点（也就是你的文本节点）一起清理，不用手动操作。

代码示例： #

1. 识别图像时将文本节点添加到锚点节点：

func renderer(_ renderer: SCNSceneRenderer, didAdd node: SCNNode, for anchor: ARAnchor) {
    guard let imageAnchor = anchor as? ARImageAnchor else { return }
    
    // 创建文本几何
    let textGeo = SCNText(string: "找到目标图像！", extrusionDepth: 0.05)
    textGeo.firstMaterial?.diffuse.contents = UIColor.blue
    let textNode = SCNNode(geometry: textGeo)
    
    // 调整文本位置（放在图像前方，避免遮挡）
    textNode.position = SCNVector3(0, 0, -0.1)
    // 缩小文本，SCNText默认尺寸很大
    textNode.scale = SCNVector3(0.01, 0.01, 0.01)
    
    // 关键：把文本节点添加到锚点对应的node上，而非场景根节点
    node.addChildNode(textNode)
}

2. 重置会话时传入正确的配置选项：

@IBAction func resetButtonTapped(_ sender: UIButton) {
    let configuration = ARImageTrackingConfiguration()
    // 加载你的识别图像集
    guard let referenceImages = ARReferenceImage.referenceImages(inGroupNamed: "AR Resources", bundle: nil) else {
        print("无法加载识别图像")
        return
    }
    configuration.trackingImages = referenceImages
    
    // 重置追踪+移除所有旧锚点，旧的锚点节点（含文本）会被自动清理
    arView.session.run(configuration, options: [.resetTracking, .removeExistingAnchors])
}

方法二：手动保存文本节点引用，重置时主动移除 #

如果你的文本节点是直接添加到场景根节点（arView.scene.rootNode），那需要手动保存它的引用，在重置会话前主动从父节点移除。

代码示例： #

1. 在ViewController中定义变量保存文本节点：

// 保存文本节点的可选引用，方便后续查找和移除
private var currentTextNode: SCNNode?

2. 识别图像时先清理旧节点，再添加新节点：

func renderer(_ renderer: SCNSceneRenderer, didAdd node: SCNNode, for anchor: ARAnchor) {
    guard let imageAnchor = anchor as? ARImageAnchor else { return }
    
    // 先移除旧的文本节点（如果存在）
    currentTextNode?.removeFromParentNode()
    
    // 创建新文本节点
    let textGeo = SCNText(string: "识别成功！", extrusionDepth: 0.05)
    textGeo.firstMaterial?.diffuse.contents = UIColor.red
    currentTextNode = SCNNode(geometry: textGeo)
    
    // 调整位置和缩放
    currentTextNode?.position = SCNVector3(node.position.x, node.position.y, node.position.z - 0.1)
    currentTextNode?.scale = SCNVector3(0.01, 0.01, 0.01)
    
    // 添加到场景根节点
    arView.scene.rootNode.addChildNode(currentTextNode!)
}

3. 重置会话时先清理文本节点：

@IBAction func resetButtonTapped(_ sender: UIButton) {
    // 主动移除文本节点并清空引用
    currentTextNode?.removeFromParentNode()
    currentTextNode = nil
    
    // 重置ARKit会话
    let configuration = ARImageTrackingConfiguration()
    guard let referenceImages = ARReferenceImage.referenceImages(inGroupNamed: "AR Resources", bundle: nil) else {
        print("加载图像失败")
        return
    }
    configuration.trackingImages = referenceImages
    arView.session.run(configuration, options: [.resetTracking, .removeExistingAnchors])
}

两种方法都能解决问题，推荐第一种，因为它利用ARKit的锚点生命周期自动管理节点，代码更简洁省心。

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