PurpleAir-AQI-Scriptable-Widget 项目使用教程
1. 项目的目录结构及介绍
PurpleAir-AQI-Scriptable-Widget 项目的目录结构相对简单,主要包含以下文件和文件夹:
- LICENSE: 项目许可证文件,采用 Unlicense 许可证。
- README.md: 项目说明文档,包含项目的基本信息和使用指南。
- purpleair-aqi.js: 项目的主要脚本文件,用于生成空气质量指数(AQI)的 Scriptable 小部件。
2. 项目的启动文件介绍
项目的启动文件是 purpleair-aqi.js
。该文件的主要功能是查询 PurpleAir 传感器并显示本地的 AQI。以下是该文件的主要内容和功能介绍:
- API 请求: 通过 PurpleAir API 获取空气质量数据。
- 位置服务: 使用设备的位置服务来找到最近的 PurpleAir 站点。
- 小部件显示: 将获取的 AQI 数据显示在 Scriptable 小部件上。
3. 项目的配置文件介绍
项目没有专门的配置文件,但 purpleair-aqi.js
脚本中包含一些需要用户配置的变量:
- API 密钥: 需要用户从 PurpleAir 获取 API 密钥,并将其填入脚本中的
API_KEY
变量。 - 传感器 ID: 用户可以选择手动指定一个 PurpleAir 传感器的 ID,或者使用位置服务自动查找最近的传感器。
以上是 PurpleAir-AQI-Scriptable-Widget 项目的基本使用教程,希望对您有所帮助。