企业官网建设流程全解析

HoloCubic_AIO新旧天气时钟对比：高德API与心知天气，哪个更适合你

【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO

如果你正在给 HoloCubic 幻视屏刷入 HoloCubic_AIO 多功能固件，一定会遇到内置的两套天气时钟：新版使用高德API，旧版使用心知天气（Seniverse）。本文帮你快速搞清楚二者的差别、配置方式和适用人群，选对不踩坑。

HoloCubic AIO天气时钟是什么

HoloCubic_AIO 是一款基于 ESP32 的开源"全能"固件，把天气时钟、相册、视频播放、桌面投屏、Web 服务、B站粉丝数等功能集成到一个立方体屏幕上。天气时钟是其中最常用的核心功能之一：开机联网后自动拉取所在城市天气，在亚克力屏幕里显示城市、温度与天气图标。

固件采用低耦合的模块化设计，每个功能都是一个独立 APP，由中央控制器统一调度，天气模块的路径见 AIO_Firmware_PIO/src/app/weather/，旧版模块在 AIO_Firmware_PIO/src/app/weather_old/。

新版天气时钟：高德API怎么工作

新版天气APP由社区开发者 PuYuuu 编写，源码入口在 AIO_Firmware_PIO/src/app/weather/weather.cpp，它调用高德地图开放平台的两组天气接口：

相比旧版，新版的几个明显优势：

• 支持中文城市名：直接填"北京"即可，也支持城市adcode；
• 带4天温度预报曲线：界面上可绘制未来几天的最高/最低温，见 weather_gui.h 中的预报数据结构；
• 天气现象映射完善：内置了晴、多云、雷阵雨、雨夹雪、沙尘暴、霾等完整对照表（weather.cpp），配合 放置到内存卡/weather/ 中70多个天气图标素材；
• 配置持久化：城市、API Key、更新间隔默认保存为weather_2111.cfg，天气默认每15分钟刷新一次。

响应示例可参考 API返回备忘.json，调试时对照它很容易看懂字段含义。

旧版天气时钟：心知天气怎么工作

旧版代码位于 AIO_Firmware_PIO/src/app/weather_old/weather_old.cpp，调用心知天气的weather/now.json接口：

• 城市参数使用英文/拼音名（如Beijing），语言默认zh-Hans；
• 只返回当前时刻的天气代码与温度，没有多日预报和湿度风力细分；
• 图标体系与和风天气风格对齐，相关背景说明见 weather_old/README.md；
• 配置独立保存在weather_old.cfg，与新版互不干扰。

也就是说，旧版胜在轻量，但信息维度明显弱于新版。

新旧版关键差异对比

两套模块都可以独立编译开关，统一在 AIO_Firmware_PIO/src/app/app_conf.h 中通过宏定义控制，关闭不用的APP还能腾出Flash空间。

哪个更适合你：3种场景推荐

• 大多数用户 → 选新版高德天气时钟：中文城市名更省心，信息更全，还有预报曲线，是默认推荐；
• 只想显示一句话天气的极简派：旧版心知天气足够轻，且如果你已经持有Seniverse的Key，无需重新申请；
• 想自己魔改：新版数据结构字段更全（见 weather_gui.h），扩展UI和自定义图标更方便。

配置入口统一在固件的Web设置页面，填入对应API Key和城市即可，配置项会自动写入Flash持久化。

快速刷机与配置步骤

1. 克隆仓库获取固件与工具：git clone https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO
2. 使用开源上位机 HoloCubic_AIO_Tool 完成刷写（界面如下），无需搭建IDE环境；
3. 设备连上2.4G WiFi后，进入Web配置页面填写城市与API Key，等待首次天气刷新。

结论

新版高德天气时钟在信息量、易用性和扩展性上全面胜出，是 HoloCubic AIO 天气功能的默认之选；旧版心知天气则保留给极简显示需求和已有Key的老用户。两者并存、配置互不干扰，你可以按自己的习惯自由选择。更多APP玩法与硬件说明，可继续查看 README.md 与 HoloCubic小电视──小白避坑指南v2.3.md。

【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO