如何通过ARKit与ARGeoTrackingConfiguration获取设备朝向

当ARGeoTrackingStatus进入.localized状态后，ARKit已将世界坐标系对齐到真北地理方位，你可以通过以下两种可靠方式获取设备相对于真北的0-360°朝向：

方法一：直接从ARFrame的Camera获取（推荐） #

利用ARSession更新的ARFrame中相机的欧拉角，无需额外权限，且与AR场景坐标系完全对齐，避免偏差。

func session(_ session: ARSession, didUpdate frame: ARFrame) {
    // 仅在地理定位完成后处理
    guard session.currentGeoTrackingStatus.state == .localized else { return }
    
    // 获取相机绕垂直轴（世界Z轴）的旋转角（Yaw），范围为 -π ~ π
    let yawRadians = frame.camera.eulerAngles.y
    
    // 将弧度转换为0-360°的角度（0°=真北，顺时针递增）
    let trueNorthHeading = (yawRadians + .pi) * 180 / .pi
    
    // 传入角度调整自定义视图
    updateCustomViewOrientation(with: trueNorthHeading)
}

// 示例：调整自定义视图朝向
func updateCustomViewOrientation(with heading: Double) {
    // 假设你需要让视图朝向某个目标地理方位（比如180°=正南）
    let targetHeading = 180.0
    // 计算视图需要旋转的角度（适配UIKit坐标系，旋转方向可根据需求调整）
    let rotationAngle = (targetHeading - heading) * .pi / 180
    customView.transform = CGAffineTransform(rotationAngle: CGFloat(rotationAngle))
}

关键说明： #

• ARGeoTracking本地化后，世界坐标系规则为：Z轴垂直向上，Y轴指向真北，X轴指向正东。
• 相机的eulerAngles.y代表绕Z轴的旋转角，0°对应真北，顺时针旋转角度递增（90°=正东，180°=正南，270°=正西）。

方法二：通过CoreMotion获取实时朝向 #

如果需要更高频的朝向更新，可以结合CoreMotion的设备运动数据，需确保坐标系与ARGeoTracking对齐：

import CoreMotion

// 初始化CoreMotion管理器（建议在视图控制器初始化时完成）
let motionManager = CMMotionManager()

override func viewDidLoad() {
    super.viewDidLoad()
    // 启动设备运动更新，使用真北对齐的坐标系
    motionManager.startDeviceMotionUpdates(using: .xTrueNorthZVertical)
}

func session(_ session: ARSession, didUpdate frame: ARFrame) {
    guard session.currentGeoTrackingStatus.state == .localized,
          let motionData = motionManager.deviceMotion else { return }
    
    // 直接获取相对于真北的0-360°朝向
    let trueNorthHeading = motionData.attitude.heading
    
    // 调整视图
    updateCustomViewOrientation(with: trueNorthHeading)
}

注意事项： #

• 确保CoreMotion使用xTrueNorthZVertical参考坐标系，与ARGeoTracking的世界坐标系保持一致，避免偏差。
• 部分设备可能需要校准指南针，可通过CMMotionManager的校准提示引导用户完成。

解决朝向偏差的额外排查点 #

如果自定义视图仍有偏差，检查以下内容：

• 确认自定义视图的初始朝向基准（比如是否默认朝向屏幕正前方，而非镜头方向）。
• 检查AR视图的automaticallyUpdatesLighting等配置是否影响坐标系转换。
• 确保在ARSession启动前已获得位置权限（ARGeoTracking需要CLAuthorizationStatus.authorizedAlways或.authorizedWhenInUse）。

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