如何在HealthKit中查询HeartRates以获得传统的HKQuantitySamples和累积数量样本？

在HealthKit中查询心率（Heart Rates）数据可以通过两种方式获得：传统的HKQuantitySamples和累积数量样本（Cumulative Quantity Samples）。下面我将详细介绍这两种方式的基础概念、优势、类型、应用场景以及如何进行查询。

基础概念

HKQuantitySample：
- HKQuantitySample是HealthKit中表示单一数据样本的类。每个样本包含一个值、单位和一个时间戳。
- 适用于记录特定时间点的数据，例如某一时刻的心率。

累积数量样本（Cumulative Quantity Sample）：
- 累积数量样本表示一段时间内数据的累积值。例如，一段时间内的总步数或总心率。
- 适用于需要计算一段时间内数据总和的场景。

优势

HKQuantitySample：
- 精确记录单个时间点的数据。
- 适用于需要精确时间戳的应用，如运动分析、健康监测等。
累积数量样本：
- 计算一段时间内数据的总和。
- 适用于需要统计一段时间内的数据总量的应用，如日、周、月的健康数据总结。

类型

HKQuantitySample：
- 单个数据点，包含值、单位和时间戳。
累积数量样本：
- 一段时间内数据的累积值，包含起始时间、结束时间和累积值。

应用场景

HKQuantitySample：
- 实时健康监测应用，如心率监测器。
- 运动数据分析，如跑步时的心率变化。
累积数量样本：
- 健康数据总结，如每日、每周的心率总和。
- 长期健康趋势分析，如月度心率变化。

查询方法

查询传统的HKQuantitySamples

import HealthKit

func queryHeartRateSamples() {
    guard let heartRateType = HKObjectType.quantityType(forIdentifier: .heartRate) else {
        return
    }
    
    let calendar = NSCalendar.current
    let startDate = calendar.date(byAdding: .day, value: -7, to: Date())!
    let endDate = Date()
    
    let predicate = HKQuery.predicateForSamples(withStart: startDate, end: endDate, options: [])
    
    let query = HKSampleQuery(sampleType: heartRateType, predicate: predicate, limit: HKObjectQueryNoLimit, sortDescriptors: nil) { (query, samples, error) in
        guard let samples = samples else {
            print("An error occurred: \(error?.localizedDescription ?? "Unknown error")")
            return
        }
        
        for sample in samples {
            guard let quantitySample = sample as? HKQuantitySample else { continue }
            let heartRate = quantitySample.quantity.doubleValue(for: HKUnit.count().unitDivided(by: HKUnit.minuteUnit()))
            print("Heart Rate: \(heartRate) bpm")
        }
    }
    
    HKHealthStore().execute(query)
}

查询累积数量样本

import HealthKit

func queryCumulativeHeartRateSamples() {
    guard let heartRateType = HKObjectType.quantityType(forIdentifier: .heartRate) else {
        return
    }
    
    let calendar = NSCalendar.current
    let startDate = calendar.date(byAdding: .day, value: -7, to: Date())!
    let endDate = Date()
    
    let predicate = HKQuery.predicateForSamples(withStart: startDate, end: endDate, options: [.cumulativeSum])
    
    let query = HKSampleQuery(sampleType: heartRateType, predicate: predicate, limit: HKObjectQueryNoLimit, sortDescriptors: nil) { (query, samples, error) in
        guard let samples = samples else {
            print("An error occurred: \(error?.localizedDescription ?? "Unknown error")")
            return
        }
        
        for sample in samples {
            guard let cumulativeSample = sample as? HKQuantitySample else { continue }
            let heartRate = cumulativeSample.quantity.doubleValue(for: HKUnit.count().unitDivided(by: HKUnit.minuteUnit()))
            print("Cumulative Heart Rate: \(heartRate) bpm")
        }
    }
    
    HKHealthStore().execute(query)
}