iOS开发中HealthKit如何获取REM、深睡、浅睡等睡眠阶段数据

1. HealthKit 原生细分睡眠阶段支持情况 #

• iOS 16 及以上版本原生支持REM睡眠、深度睡眠、浅度（核心）睡眠的细分阶段数据读取；iOS 15 及更早系统版本的HealthKit睡眠分析仅提供卧床、入睡、清醒三种粗粒度状态，无原生细分阶段字段。
• 注意：原生支持仅代表HealthKit框架定义了对应数据字段，能否拿到实际数据取决于用户设备上的数据源（Apple Watch、第三方睡眠APP、智能穿戴设备等）是否向HealthKit写入了对应阶段的样本，未接入支持睡眠分期监测的硬件时，即使是iOS16+系统也可能拿不到有效细分数据。

2. 原生细分睡眠阶段数据实现方式 #

你现有拉取睡眠数据的核心逻辑不需要修改，不需要新增查询的ObjectType，细分睡眠阶段和原有粗粒度睡眠数据共用HKObjectType.categoryType(forIdentifier: .sleepAnalysis)类型，差异仅在返回的HKCategorySample的value字段对应不同枚举值。
具体实现步骤：

• 做好系统版本适配，仅在iOS16及以上系统解析细分阶段枚举
• 遍历查询返回的HKCategorySample，按value值过滤对应阶段的样本即可

核心过滤代码示例：

// 解析睡眠细分阶段（仅iOS16+可用）
if #available(iOS 16.0, *) {
    // REM睡眠样本
    let remSleepSamples = samples.filter { 
        $0.value == HKCategoryValueSleepAnalysis.asleepREM.rawValue 
    }
    // 深度睡眠样本
    let deepSleepSamples = samples.filter { 
        $0.value == HKCategoryValueSleepAnalysis.asleepDeep.rawValue 
    }
    // 核心（浅度）睡眠样本
    let coreSleepSamples = samples.filter { 
        $0.value == HKCategoryValueSleepAnalysis.asleepCore.rawValue 
    }
    // 清醒样本
    let awakeSamples = samples.filter { 
        $0.value == HKCategoryValueSleepAnalysis.awake.rawValue 
    }
    
    // 按样本的startDate、endDate计算各阶段总时长即可得到睡眠分期统计结果
}

注意：iOS 16 之后原有的粗粒度HKCategoryValueSleepAnalysis.asleep枚举已被废弃，系统会优先返回细分阶段的睡眠样本。不要尝试查找REM/深睡专属的HKObjectType，所有睡眠阶段数据都存在.sleepAnalysis这个分类类型下，这是很多开发者容易踩的坑。

3. 无原生细分数据时的实现方案 #

针对iOS16以下系统、或用户无对应硬件数据源拿不到细分阶段的场景，可选择以下落地方案：

• 对接穿戴设备厂商SDK：主流支持睡眠分期的智能手表、手环厂商均提供iOS端开放SDK，可直接获取设备端算法计算好的细分睡眠数据，数据精度和设备本身监测能力一致，是商用睡眠APP最常用的方案。
• 读取第三方睡眠APP写入数据：如果用户已安装成熟睡眠监测类APP，且这些APP已向HealthKit写入细分睡眠阶段数据，你只需要拿到HealthKit读取权限即可直接获取对应分期数据，不需要自行计算。
• 自研睡眠分期算法：如果要实现无硬件依赖的睡眠监测，可申请后台加速度计、麦克风、心率读取权限，通过夜间体动、环境音、心率波动特征，结合预训练的睡眠分期模型做本地推理。但该方案门槛较高：一方面需要大量标注的睡眠数据训练模型保证准确率，另一方面如果手机未贴身放置（比如放床头柜），传感器数据无效，结果准确率会非常低，不建议作为核心方案。

额外注意：统计睡眠阶段时需要先做数据源去重，同一时间段可能存在多个数据源（比如手机、手表、第三方APP）写入的重叠样本，建议按「穿戴设备 > 第三方睡眠APP > 手机系统记录」的优先级筛选样本，避免时长统计重复。

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