Skip to content

天气与旧远程资源 ​

当前活动来源为设备屏幕的单一“心知天气”实况组件。旧远程 MQTT 通道、自定义 HTTP 来源和多天气来源已退出活动配置,不能按早期文档继续创建远程开关、场景或可写数值。

配置天气 ​

在“设备屏幕”的心知天气组件配置城市和 API Key,选择每 15、30 或 60 分钟自动刷新。来源固定为 seniverse、实况 now.json 接口和摄氏单位;不提供自定义 URL、三日预报或任意 JSON 路径读取。API Key 是私有凭据,公开示例与报告不要包含真实值。

固件须编译 remoteResources,依赖网络、时间与资源准入,并按设备返回状态判断是否可用。旧配置中的来源与凭据保留为迁移资料;确认保留的心知天气来源或新建来源后,系统规范化为最多一个活动天气来源。若删除的来源仍被规则引用,包括停用规则,迁移会拒绝并要求先调整引用,不能静默丢弃配置。

刷新与显示 ​

手动刷新与规则动作 34 都只请求已配置来源更新,受最短间隔和待处理状态限制。accepted=true 仅表示已接收请求;应继续查看 pending、结果、原采样时间与质量。限流、无网络、服务错误及过期结果不能用零值伪装新天气。反复刷新不会延长旧样本有效期。

动作 34 的 targetPeriphId 为设备返回的实际天气来源 ID,actionValue 必须为空。不能填入 URL,也不能借此查询 MQTT 通道。

当前接口 ​

路径方法与用途
/api/screen-panel/weatherGET 查看;POST 保存天气配置
/api/screen-panel/weather/refresh?id=<来源ID>POST 请求刷新;GET 查看刷新状态
/api/remote-resourcesGET/POST 均返回 410,旧入口停用
/api/remote-resources/weather-testGET/POST 均返回 410,旧测试入口停用

接口要求登录;保存和刷新状态/请求还要求开发环境功能开启。保存使用设备返回的版本,冲突返回 409 后先刷新配置。完整配置正文上限 8 KiB。

旧规则处理 ​

动作 33 保留编号用于识别退休配置,不能执行远程通道控制。绑定旧 remote. 数据源或 ds:remote. 事件的规则会暂停整条规则,包含其中其他 OR 触发器。修改前核对规则状态与暂停原因,重新选择当前来源和动作,不自动转投其它设备。此保护不代表旧远程负载的实际状态已确认。

屏幕卡片与天气状态见设备屏幕,本地传感器显示见显示动作。

蜂信物联 | fastbee.cn