用途:EnergyKit 用于在 iOS/iPadOS 应用中查询电网电力清洁度与成本预测,并提交设备负载遥测,帮助用户把用电安排到更清洁或更便宜的电网时段。目标平台为 Swift 6.3 / iOS 26+。
主要能力:
- 电力指引(Electricity Guidance):提供按时间加权的预测流,指示电网何时更清洁、更便宜。可调度负载(如电动车充电、电池储能)使用 .shift;削减类负载(如 HVAC 温控回调)使用 .reduce。
- 负载事件(Load Events):由受管设备提交遥测,确认实际用电时段;提交的设备与场所标识必须与获取指引时一致。
- 能源场所(Energy Venues):在用户 Apple Home 环境中注册的物理位置 EnergyVenue。
- 历史洞察:借助 ElectricityInsightService 获取历史用电记录、成本明细与费率分析。
- Home 应用集成:iOS/iPadOS 27+ 的 ElectricalLoadDevice 与 Home 应用 LoadEvents 集成属于 beta 敏感能力。
语义与用法要点:
- 指引评分范围 0.0(最脏/最贵)到 1.0(最清洁/最便宜),以连续区间流形式发出,应始终观察更新,因为预测随天气与需求尖峰动态变化。
- 用电完成后应尽快提交负载事件,使历史洞察准确反映节省。
- 需 com.apple.developer.energykit 权限,并在应用 target 上启用 EnergyKit 能力;缺失授权时处理 EnergyKitError.permissionDenied。
限制:
- 核心 EnergyKit API 需要 iOS/iPadOS 26.0+;iOS/iPadOS 27+ 相关 API 为 beta 敏感。扩展区域外会返回 EnergyKitError.unsupportedRegion,受支持区域为美国本土连续区域。
- 常见错误包括缺少权限导致静默失败、未处理区域不支持、设备或场所标识不匹配、未动态观察指引更新、在 iOS 26 部署目标上未做可用性检查就使用 iOS 27 的 ElectricalLoadDevice。
- 具体价格、收费模式、平台支持细节资料中未提供。