如何在ARKit中获取ARImageAnchor相对指定SCNNode的朝向数据？

核心问题原因 #

1. OriginNode初始化不规范：若originNode仅作为空节点直接添加到根节点，未基于AR会话启动时的初始相机姿态设置transform，会导致相对旋转的基准坐标系错误。
2. 坐标系方向未适配landscapeRight：ARKit默认世界坐标系以设备竖屏（portrait）为基准，设备固定为landscapeRight时轴映射关系发生变化，直接计算欧拉角会出现方向偏移。
3. 变换转换逻辑错误：原代码中node.convertTransform(SCNMatrix4(), to: originNode)用法有误，未正确将图像锚点的世界变换转换到originNode的局部坐标系。

修复步骤 #

1. 正确初始化OriginNode #

在AR会话启动时，将originNode的transform绑定到初始相机姿态，确保基准坐标系为会话启动时的相机视角：

var originNode = SCNNode()

func session(_ session: ARSession, didAdd anchors: [ARAnchor]) {
    guard let initialCameraAnchor = anchors.first as? ARCameraAnchor else { return }
    // 仅在会话首次启动时初始化originNode
    if originNode.parent == nil {
        originNode.transform = SCNMatrix4(initialCameraAnchor.transform)
        sceneView.scene.rootNode.addChildNode(originNode)
    }
}

2. 锁定设备方向为landscapeRight #

确保设备始终处于目标方向，避免坐标系动态变化：

UIDevice.current.setValue(UIDeviceOrientation.landscapeRight.rawValue, forKey: "orientation")

3. 修正朝向计算逻辑 #

替换原代理方法中的朝向计算代码，正确处理变换转换和方向补偿：

func renderer(_ renderer: SCNSceneRenderer, didAdd node: SCNNode, for anchor: ARAnchor) {
    guard let imageAnchor = anchor as? ARImageAnchor else { return }
    
    // 计算相对originNode的位置（原逻辑正确，保留）
    let relativePosition = node.convertPosition(.zero, to: originNode)
    print("相对位置：X=\(relativePosition.x), Y=\(relativePosition.y), Z=\(relativePosition.z)")
    
    // 正确将图像锚点的世界变换转换到originNode的局部坐标系
    let worldToOriginTransform = originNode.convertTransform(imageAnchor.transform, from: nil)
    let simdTransform = simd_float4x4(worldToOriginTransform)
    
    // 补偿landscapeRight方向：将ARKit世界坐标系旋转到设备视角参考系
    let orientationAdjustment = simd_float4x4(rotation: simd_quatf(angle: .pi/2, axis: SIMD3(0,0,1)))
    let adjustedTransform = simdTransform * orientationAdjustment
    
    // 提取朝向与向上向量
    let forward = -adjustedTransform.columns.2.xyz
    let up = adjustedTransform.columns.1.xyz
    
    // 计算Tilt（上下倾斜）、Pan（左右偏转）、Roll（翻滚）
    let tilt = atan2(forward.y, forward.z)
    let pan = atan2(forward.x, forward.z)
    let roll = atan2(-up.x, up.y)
    
    print("Tilt: \(tilt.rad2deg()), Pan: \(pan.rad2deg()), Roll: \(roll.rad2deg())")
}

// 确保角度转换扩展正确
extension Float {
    func rad2deg() -> Float {
        return self * 180 / .pi
    }
}

4. 可选：调整世界对齐方式 #

若不需要方向参考（仅基于重力），可修改AR配置的世界对齐方式，避免航向角干扰：

configuration.worldAlignment = .gravity

验证效果 #

修改后，图像朝向变化时，tilt、pan、roll的值会正确反映图像相对于originNode的朝向，解决固定输出0或-180的异常问题。

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