CoreMotion Heading 不一致：应用重启后需重新校准罗盘

核心问题：用错API导致方向偏移 #

你当前代码存在变量未定义的错误，更关键的是误用了deviceMotion获取方向——deviceMotion.attitude.yaw是相对设备初始姿态的角度，并非基于地理北的绝对方向。关闭应用再重启后，初始姿态基准改变，自然会出现方向偏差。而系统自带罗盘用的是专门的磁罗盘API，基于绝对地理磁场，所以能稳定指向正北。

正确实现方案：使用磁罗盘API获取稳定方向 #

要获取和系统罗盘一致的稳定方向，应该用CMMotionManager的startHeadingUpdates方法，直接读取磁北或真北的heading值。以下是修正后的代码：

import CoreMotion
import SwiftUI

class Compass: ObservableObject {
    private var motionManager: CMMotionManager
    @Published var magneticHeading: Double = 0.0
    @Published var needsCalibration: Bool = false

    init() {
        self.motionManager = CMMotionManager()
        self.startHeadingUpdates()
    }
    
    private func startHeadingUpdates() {
        guard motionManager.isHeadingAvailable else {
            print("当前设备不支持罗盘功能")
            return
        }
        
        // 设置更新频率（0.1秒一次，和系统罗盘一致）
        motionManager.headingUpdateInterval = 0.1
        // 选择磁北作为参考系（和系统罗盘默认一致）
        motionManager.headingReferenceFrame = .magneticNorthZVertical
        
        motionManager.startHeadingUpdates(to: .main) { [weak self] heading, error in
            guard let heading = heading else { return }
            
            // 判断是否需要校准（accuracy<0表示校准未完成）
            self?.needsCalibration = heading.accuracy < 0
            
            // 归一化heading到0-360度范围
            let normalized = heading.magneticHeading.truncatingRemainder(dividingBy: 360)
            self?.magneticHeading = normalized >= 0 ? normalized : normalized + 360
        }
    }
    
    deinit {
        // 页面销毁时停止更新，避免资源泄漏
        motionManager.stopHeadingUpdates()
    }
}

关键细节说明 #

• API选择：startHeadingUpdates直接读取磁罗盘硬件数据，系统会自动处理硬铁/软铁误差补偿，和系统罗盘使用同一套校准逻辑。
• 校准提示：通过heading.accuracy可以判断是否需要校准，当值小于0时，可提示用户做8字形晃动手机完成校准。
• 磁北vs真北：
  • magneticHeading：基于地球磁场的磁北方向，无需定位权限，和系统罗盘默认一致。
  • trueHeading：基于地理北极的真北方向，需要开启定位权限（添加NSLocationWhenInUseUsageDescription到Info.plist），结合GPS数据计算得出。
• 归一化处理：确保heading值始终在0-360度范围内，避免出现负数或超过360的情况。

为什么系统罗盘稳定？ #

系统自带罗盘应用使用了系统级的罗盘校准机制，会自动存储设备的硬铁/软铁校准数据，即使重启应用也能复用校准结果；同时会结合传感器融合（加速计、陀螺仪、磁罗盘）进一步优化方向精度，所以能保持稳定的正北指向。

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