SuperAPI AI 工具集

energykit

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

EnergyKit 是 Apple 提供的 iOS/iPadOS 框架,用于查询电网电力预测(Electricity Guidance)并提交受管设备的负载事件(Load Events),帮助智能家居、电动车充电与暖通空调类应用优化家庭用电。核心 API 自 iOS/iPadOS 26 起提供,部分洞察细分 API(含电网清洁度分类)为 26.1+,需做可用性判断;iOS/iPadOS 27 的 ElectricalLoadDevice 与面向 Home 的 LoadEvents 体验处于 beta,使用前应重新核对 Apple 文档。

主要能力:一是电力预测,通过 ElectricityGuidance.Service 获取按时间加权的预测流,每个 ElectricityGuidance.Value 含时间区间与 0.0(最佳)到 1.0(最差)的评分,查询可指定 .shift(如电动车充电)或 .reduce(如暖通空调降载)动作;二是负载事件,由请求预测的同一设备/应用提交 EV 充电或 HVAC 遥测,会话状态需保持 .begin → .active → .end 并及时提交;三是电力洞察,通过 ElectricityInsightService 查询历史能耗与运行数据,可按电价或电网清洁度细分。

使用方式:需 import EnergyKit,并在应用目标启用 com.apple.developer.energykit 能力;iOS/iPadOS 27+ 若需 Home 应用中的设备名称、能耗上下文、活动日志、图表或趋势通知,还需 EnergyKit LoadEvents 能力。用 EnergyVenue.venues() 发现场所,不要硬编码场所 ID。

限制:Apple 目前仅记录美国本土的电力预测,需处理 EnergyKitError.unsupportedRegion;缺少权限会返回 permissionDenied;不得伪造或丢弃 guidance token;不要用 MetricKit 指标替代 EnergyKit 负载事件或洞察;洞察粒度需匹配最小聚合窗口(如七天视图用 .hourly,.daily 至少覆盖一个日历月)。