为健身应用配置WatchKit以获取更频繁的心率数据

阿华AIGC实验室

2026-5-27

解决Apple Watch心率实时监测更新频率问题

Hey Kevin, 针对你遇到的健身App心率更新频率不足的问题，我给你整理了几个关键的实现步骤，都是Apple官方推荐的方案，帮你搞定实时心率监测：

1. 放弃定时器轮询，改用HealthKit实时查询API

定时器轮询不仅效率低，还容易错过中间的心率数据，HealthKit提供了专门的实时监听机制，这才是正确的打开方式：

HKAnchoredObjectQuery：专门监听特定类型数据的新增/删除，每次有新心率数据写入HealthKit就会触发回调，完美适配实时监测场景。
HKObserverQuery：可以触发后台唤醒任务，适合需要在后台持续监测心率的场景。

示例代码（Watch Extension中实现）：

import HealthKit

class HeartRateMonitor {
    private let healthStore = HKHealthStore()
    private var queryAnchor: HKQueryAnchor?
    
    func startRealTimeMonitoring() {
        guard let heartRateType = HKObjectType.quantityType(forIdentifier: .heartRate) else { return }
        
        // 先请求HealthKit权限
        healthStore.requestAuthorization(toShare: nil, read: [heartRateType]) { [weak self] success, error in
            guard success, let self = self else {
                print("心率权限请求失败：\(error?.localizedDescription ?? "未知错误")")
                return
            }
            
            // 初始化锚定查询，监听心率数据变化
            let anchoredQuery = HKAnchoredObjectQuery(
                type: heartRateType,
                predicate: nil,
                anchor: self.queryAnchor,
                limit: HKObjectQueryNoLimit
            ) { query, samples, deletedObjects, newAnchor, error in
                DispatchQueue.main.async {
                    self.queryAnchor = newAnchor
                    self.processNewHeartRateSamples(samples)
                }
            }
            
            // 设置实时更新回调
            anchoredQuery.updateHandler = { query, samples, deletedObjects, newAnchor, error in
                DispatchQueue.main.async {
                    self.queryAnchor = newAnchor
                    self.processNewHeartRateSamples(samples)
                }
            }
            
            self.healthStore.execute(anchoredQuery)
        }
    }
    
    private func processNewHeartRateSamples(_ samples: [HKSample]?) {
        guard let heartRateSamples = samples as? [HKQuantitySample] else { return }
        for sample in heartRateSamples {
            // 转换为常用的BPM单位
            let heartRateBPM = sample.quantity.doubleValue(for: HKUnit.count().unitDivided(by: HKUnit.minute()))
            print("实时心率：\(heartRateBPM) BPM")
            // 这里同步更新Watch端的UI（注意必须在主线程）
        }
    }
}

2. 启动HKWorkoutSession提升心率采样率

Apple Watch在普通模式下心率采样率很低（几分钟一次），但启动HKWorkoutSession后，系统会进入健身模式，心率传感器会自动提高采样频率（最高可达1次/秒），这是实现实时监测的核心前提：

func startFitnessWorkoutSession() {
    let workoutConfig = HKWorkoutConfiguration()
    workoutConfig.activityType = .generic // 根据你的健身类型调整，比如跑步、力量训练等
    workoutConfig.locationType = .indoor // 室外健身选.outdoor
    
    do {
        let workoutSession = try HKWorkoutSession(healthStore: healthStore, configuration: workoutConfig)
        workoutSession.delegate = self
        workoutSession.startActivity(with: Date())
    } catch {
        print("启动健身会话失败：\(error.localizedDescription)")
    }
}

// 实现HKWorkoutSessionDelegate处理会话状态
extension HeartRateMonitor: HKWorkoutSessionDelegate {
    func workoutSession(_ workoutSession: HKWorkoutSession, didChangeTo toState: HKWorkoutSessionState, from fromState: HKWorkoutSessionState, date: Date) {
        // 处理会话状态变化，比如开始、暂停、结束
        switch toState {
        case .running:
            print("健身会话已启动，心率采样率提升")
        case .ended:
            print("健身会话结束")
        default:
            break
        }
    }
    
    func workoutSession(_ workoutSession: HKWorkoutSession, didFailWithError error: Error) {
        print("健身会话出错：\(error.localizedDescription)")
    }
}

3. 配置Watch扩展的后台权限与Info.plist

确保你的Watch Extension的Info.plist包含以下关键配置，不然后台监测会失效：

添加NSHealthShareUsageDescription和NSHealthUpdateUsageDescription键，填写清晰的权限说明文本（Apple审核必填）。
在UIBackgroundModes数组中添加health-update，允许App在后台监听HealthKit数据变化。