使用HKStatisticsCollectionQuery获取指定时间段血氧最大最小值相关问题

前置检查项 #

• 首先确认已向用户申请血氧数据读取权限，对应数据类型为HKObjectType.quantityType(forIdentifier: .oxygenSaturation)，查询前可通过HKHealthStore.authorizationStatus(for:)方法确认权限状态为已授权。
• 构造HKStatisticsCollectionQuery时必须明确指定统计选项，需包含.discreteMin、.discreteMax、.discreteAverage三个枚举值，否则minimumQuantity()、maximumQuantity()方法会返回空值。

现有代码优化 #

你现有代码中单位构造可替换为系统提供的API，避免手动输入字符串出错：

let oxygenUnit = HKUnit.percent()
for stat in stats {
    let min = stat.minimumQuantity()?.doubleValue(for: oxygenUnit)
    let avg = stat.averageQuantity()?.doubleValue(for: oxygenUnit)
    let max = stat.maximumQuantity()?.doubleValue(for: oxygenUnit)
    output.append(Health.BloodOx(date: stat.startDate, min: min, avg: avg, max: max))
}

完整查询示例 #

以下是可直接使用的完整查询逻辑，覆盖从参数构造到结果处理的全流程：

import HealthKit

// 全局HealthStore实例，建议全局持有不要重复创建
let healthStore = HKHealthStore()

func fetchBloodOxygenStatistics(startDate: Date, endDate: Date, interval: DateComponents) {
    // 校验设备是否支持血氧类型
    guard let oxygenType = HKObjectType.quantityType(forIdentifier: .oxygenSaturation) else {
        print("当前设备不支持血氧数据读取")
        return
    }
    // 校验权限
    guard healthStore.authorizationStatus(for: oxygenType) == .sharingAuthorized else {
        print("未获得血氧数据读取权限，请先申请权限")
        return
    }
    // 构造查询条件
    let predicate = HKQuery.predicateForSamples(withStart: startDate, end: endDate, options: .strictStartDate)
    let query = HKStatisticsCollectionQuery(
        quantityType: oxygenType,
        quantitySamplePredicate: predicate,
        options: [.discreteMin, .discreteMax, .discreteAverage],
        anchorDate: startDate,
        intervalComponents: interval
    )
    // 结果回调
    query.initialResultsHandler = { _, statisticsCollection, error in
        guard let collection = statisticsCollection, error == nil else {
            print("血氧查询失败: \(error?.localizedDescription ?? "未知错误")")
            return
        }
        var resultList = [Health.BloodOx]()
        let oxygenUnit = HKUnit.percent()
        // 遍历所有分段的统计结果
        collection.enumerateStatistics(from: startDate, to: endDate) { statistics, _ in
            let minValue = statistics.minimumQuantity()?.doubleValue(for: oxygenUnit)
            let avgValue = statistics.averageQuantity()?.doubleValue(for: oxygenUnit)
            let maxValue = statistics.maximumQuantity()?.doubleValue(for: oxygenUnit)
            resultList.append(Health.BloodOx(date: statistics.startDate, min: minValue, avg: avgValue, max: maxValue))
        }
        // 切回主线程处理结果
        DispatchQueue.main.async {
            // 此处可更新UI或保存结果
            print("查询到的血氧统计结果: \(resultList)")
        }
    }
    // 执行查询
    healthStore.execute(query)
}

异常排查 #

• 若返回值全为nil，优先检查权限是否正常开启，同时确认时间范围参数是否合法（开始时间不能晚于结束时间）。
• 血氧属于离散型样本数据，统计选项不可使用cumulative开头的枚举值，否则无法返回正确统计结果。

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