关于HealthKit共享参与者数据查询及hkParticipantQuery传闻的技术问询

一、如何查询共享参与者的数据 #

要访问Apple Health中共享参与者的数据，需按以下流程操作：

• 获取共享参与者列表：通过HKHealthStore的fetchSharedParticipants(completion:)方法，获取所有已授权向你共享数据的参与者对象。
• 构建针对特定参与者的查询：创建HKQuery子类（如HKSampleQuery、HKStatisticsQuery）时，使用HKQuery.predicateForObjects(from:)生成筛选特定参与者数据的谓词，将其传入查询参数即可精准获取该参与者的健康数据。
• 配置权限：在向用户请求授权阶段，必须明确包含需要读取的共享健康数据类型，否则无法获取对应权限访问共享数据。

示例代码（Swift）：

import HealthKit

let healthStore = HKHealthStore()
// 以步数数据为例，需先确认数据类型可用
guard let stepCountType = HKObjectType.quantityType(forIdentifier: .stepCount) else {
    fatalError("Step count data type is not supported on this device")
}

// 先请求读取权限
healthStore.requestAuthorization(toShare: [], read: [stepCountType]) { success, error in
    guard success, error == nil else {
        print("Authorization failed: \(error?.localizedDescription ?? "Unknown error")")
        return
    }

    // 获取共享参与者列表
    healthStore.fetchSharedParticipants { participants, error in
        guard let participants = participants, error == nil else {
            print("Failed to fetch participants: \(error?.localizedDescription ?? "Unknown error")")
            return
        }

        // 遍历参与者，查询每个参与者的步数数据
        for participant in participants {
            let participantPredicate = HKQuery.predicateForObjects(from: participant)
            let stepQuery = HKSampleQuery(sampleType: stepCountType,
                                         predicate: participantPredicate,
                                         limit: HKObjectQueryNoLimit,
                                         sortDescriptors: nil) { _, samples, error in
                guard let samples = samples as? [HKQuantitySample], error == nil else {
                    print("Query failed for participant \(participant.uuid): \(error?.localizedDescription ?? "Unknown error")")
                    return
                }
                // 处理查询到的步数样本
                let totalSteps = samples.reduce(0.0) { $0 + $1.quantity.doubleValue(for: HKUnit.count()) }
                print("Participant \(participant.uuid) total steps: \(totalSteps)")
            }
            healthStore.execute(stepQuery)
        }
    }
}

二、关于HKParticipantQuery的传闻真实性 #

截至2024年9月16日发布的Xcode 15.0正式版及所有Xcode 15.1测试版，HealthKit Framework并未提供HKParticipantQuery这一查询类型，相关传闻不属实。目前官方SDK及文档中均无该API的正式支持，查询共享参与者数据仍需使用上述常规查询结合参与者谓词的方式。

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