用途:SensorKit 用于在获批的研究与临床研究中,访问细粒度的环境、运动、生物特征和交互传感器数据流,核心 API 为 SRSensorReader,面向 Swift 6.3 / iOS 26+。
主要能力:涵盖运动与环境(.ambientLightSensor、.accelerometer、.rotationRate、.elevation)、用户交互(.keyboardMetrics、.deviceUsageReport、.messagesUsageReport、.phoneUsageReport)、生理与健康(.speechMetrics、.faceMetrics、.wristTemperature、.heartRate)等传感器类别;支持授权请求、按时间区间拉取历史样本,以及数据删除。
使用方式:需先从 Apple 获取研究权限 com.apple.developer.sensorkit.reader.allow,并在 Info.plist 中为每种查询的传感器添加对应使用说明(如 NSSensorKitUsageDescription、NSSensorKitUsageDescriptionAmbientLightSensor)。实例化读取器前应显式请求授权:await SRSensorReader.requestAuthorization(for: sensors)。每种传感器创建一个 SRSensorReader 并指定 SRSensorReaderDelegate;确认授权后调用 startRecording(),停止用 stopRecording()。拉取历史数据时配置 SRFetchRequest 的 from 与 to 绝对时间后调用 fetch;在代理方法 didFetchResult 中处理样本,返回 true 以继续获取,完成时触发 didCompleteFetch。删除数据用 SRDeletionRequest 设置 endTime,再调用 reader.delete(request)。
适用场景:需要持续采集上述传感器流的研究项目与临床研究。
限制:SensorKit 需 Apple 权限审批,未经批准的研究配置文件签名会直接失败,标准消费级应用与模拟器无法测试,iOS 模拟器也不会录制或模拟硬件传感器流。常见错误包括未获权限即发布、在 didFetchResult 中过早返回 false 中断后续样本、遗漏每种传感器的 Info.plist 说明、查询无界时间区间导致内存耗尽。