kwgt 天气小组件 Weather 函数 多数据源配置
w(Weather)函数
kwgt 内置了 Weather 数据源,不需要额外代码就能显示实时天气:
| 函数 | 说明 |
|---|---|
$w(ct)$ | 当前天气类型(Sunny / Cloudy / Rainy 等) |
$w(c)$ | 天气代码(数字,对应不同图标) |
$w(temp)$ | 当前温度(摄氏度) |
$w(tempf)$ | 华氏度 |
$w(fl)$ | 体感温度 |
$w(humidity)$ | 湿度百分比 |
$w(wind)$ | 风速 |
$w(winddir)$ | 风向 |
$w(city)$ | 所在城市 |
$w(country)$ | 国家 |
$w(code)$ | 天气图标代码(配合 SVG 或图标库用) |
配置 Weather 数据源
kwgt 主界面 → 侧边栏 → Weather Provider:
- 选择数据源:推荐 OpenWeatherMap(免费、稳定)、Yr.No(免费、数据准确)、Accu Weather
- 设置定位方式:
- 自动定位(需要位置权限)
- 手动固定经纬度(如果你不想让 kwgt 一直开定位)
- API Key:OpenWeatherMap 需要去其官方站点免费申请一个 Key(一分钟搞定)
- 温度单位:摄氏 / 华氏
天气小组件实战
一个最基础的天气卡片:
- 矩形 Shape(卡片背景)+ 圆角 20
- 文字元素:
$w(city)$(城市名) - 文字元素:
$w(temp)$°(温度数字) - 文字元素:
$w(ct)$(天气描述,如"晴") - Shape 或 Image:根据
$w(code)$匹配对应的天气图标
进阶:背景根据天气变
$if(w(c) < 300, 'FFEE88', $if(w(c) < 600, '888888', '2244AA'))$
晴天暖黄,阴天灰,雨天蓝——把这行放进 Paint Color 字段里。
刷新频率
Weather 数据默认每 30 分钟 刷新一次。可以在 kwgt 主界面的 Weather 设置里调整。注意:
- 刷新太频繁会耗电 + 占用流量
- 大多数场景 30 分钟足够
- 如果小组件重启后天气没更新,手动进一次 kwgt 主界面就会强制刷新