Purifier Card 项目教程
项目介绍
Purifier Card 是一个为 Home Assistant Lovelace UI 设计的自定义卡片,专门用于控制空气净化器。默认情况下,Home Assistant 并不提供任何用于控制空气净化器的卡片,Purifier Card 填补了这一空白。该卡片不仅显示空气净化器的状态,还允许用户进行控制操作,如开关机、调节风速、设置自动模式等。此外,它还支持显示当前的空气质量指数(AQI)和一些额外的统计信息。
项目快速启动
安装步骤
1. 通过 HACS 安装
Purifier Card 可以通过 Home Assistant Community Store (HACS) 进行安装。只需在 HACS 的插件选项卡中搜索 "Purifier Card" 并安装即可。
2. 手动安装
- 从 最新发布版本 下载
purifier-card.js
文件。 - 将
purifier-card.js
文件放入 Home Assistant 配置目录下的config/www
文件夹中。 - 在 Lovelace 中添加资源引用:
- 使用 UI 界面:
- 导航到
配置 -> Lovelace 仪表板 -> 资源
选项卡。 - 点击
+ 添加资源
按钮。 - 设置 URL 为
/local/purifier-card.js
,并选择资源类型为JavaScript 模块
。
- 导航到
- 使用 YAML 配置: 在
lovelace
部分添加以下代码:resources: - url: /local/purifier-card.js type: module
- 使用 UI 界面:
3. 添加卡片到 Lovelace UI
在 Lovelace UI 中,可以通过编辑器或 YAML 配置添加 custom:purifier-card
:
type: 'custom:purifier-card'
entity: fan.purifier
应用案例和最佳实践
应用案例
Purifier Card 可以广泛应用于家庭自动化系统中,特别是在空气质量监测和空气净化器控制方面。例如,用户可以通过 Home Assistant 的自动化功能,根据室内空气质量自动调节空气净化器的工作模式。
最佳实践
- 集成传感器数据:将空气质量传感器的数据与 Purifier Card 集成,实现自动化的空气质量管理。
- 自定义快捷方式:根据个人需求,自定义快捷方式,方便快速切换空气净化器的工作模式。
- 多设备管理:如果家中有多个空气净化器,可以通过 Lovelace 的多个卡片进行统一管理。
典型生态项目
1. Home Assistant
Home Assistant 是一个开源的家庭自动化平台,Purifier Card 是其 Lovelace UI 的一部分,用于增强用户界面。
2. HACS (Home Assistant Community Store)
HACS 是 Home Assistant 的社区插件商店,用户可以通过 HACS 方便地安装和管理 Purifier Card 等自定义插件。
3. Zigbee2MQTT
Zigbee2MQTT 是一个用于将 Zigbee 设备连接到 Home Assistant 的工具,通过它可以将支持 Zigbee 的空气净化器集成到 Home Assistant 中,并使用 Purifier Card 进行控制。
通过以上步骤和案例,您可以快速上手并充分利用 Purifier Card 的功能,提升家庭自动化系统的用户体验。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考