安装及使用 `vacuum-card` 为你的 Home Assistant 添加自定义吸尘器卡片

安装及使用 vacuum-card 为你的 Home Assistant 添加自定义吸尘器卡片

vacuum-cardVacuum cleaner card for Home Assistant Lovelace UI项目地址:https://gitcode.com/gh_mirrors/va/vacuum-card

1. 项目介绍

vacuum-card 是一个专为 Home Assistant 的 Lovelace UI 设计的自定义卡片，它允许你以美观的方式展示并控制你的智能吸尘器。此项目支持多种品牌的吸尘器，包括小米、Eufy、Ecovacs 等，提供了丰富的定制选项，如状态显示、操作快捷方式和实时地图等。

2. 项目快速启动

通过 HACS 安装

1. 启用 HACS：如果你还没安装 HACS，前往你的 Home Assistant 的配置 -> 集成 -> 添加集成 -> 搜索 "HACS" 并按指示安装。
2. 在 HACS 中查找 vacuum-card：在 HACS 的插件界面搜索 "Vacuum Card" 并安装最新版本。

手动安装

1. 下载文件：访问 https://github.com/denysdovhan/vacuum-card/releases 最新版本并下载 vacuum-card.js 文件。
2. 放置文件：将该文件放入你的 config/www 目录下。
3. 添加资源：
   • 使用 UI：配置 -> Lovelace 仪表盘 -> 资源标签 -> 点击加号按钮 -> URL 设置为 /local/vacuum-card.js -> 资源类型设置为 JavaScript 模块。
   • 使用 YAML：在 lovelace 部分添加以下资源配置：

     resources:
       - url: /local/vacuum-card.js
         type: module
     

在 Lovelace 中使用

• 通过 UI 编辑器：

  1. 在 Lovelace UI 上点击左上角的三个点，选择“配置 UI”。
  2. 点击“+”按钮，添加新卡片。
  3. 在列表中找到“Custom: Vacuum Card”，选择实体以完成配置。

• 或者，通过 YAML 配置：

  type: 'custom:vacuum-card'
  entity: vacuum.vacuum_cleaner
  # 其他相关配置项...
  

3. 应用案例和最佳实践

你可以将 vacuum-card 用于以下场景：

• 显示详细的吸尘器状态，如滤网寿命、边刷寿命等。
• 自定义快捷操作，如启动清扫、分区清扫等，无需进入详情页。
• 实时查看吸尘器的地图和工作区域，以便了解其清扫进度。

最佳实践：

• 保持 Lovelace 卡片配置整洁，避免过多不必要的参数。
• 根据实际设备功能调整状态显示和操作动作。
• 尝试使用 YAML 配置来获得更精确的控制，而非只依赖 UI 编辑器。

4. 典型生态项目

vacuum-card 可很好地融入 Home Assistant 生态系统，与其他组件如 Xiaomi MiIO、Eufy、Ecovacs 等配合使用，实现全面的智能家居体验。此外，你可以结合其他自定义 Lovelace 卡片（例如 weather-card 或 calendar-card）构建个性化的 Dashboard。

---

这个教程覆盖了 vacuum-card 的基本安装和使用步骤，以及一些实用的建议。为了获取更多信息和最新的更新，请直接访问项目仓库：denysdovhan/vacuum-card。

vacuum-cardVacuum cleaner card for Home Assistant Lovelace UI项目地址:https://gitcode.com/gh_mirrors/va/vacuum-card