小米吸尘器地图卡开源项目使用教程

小米吸尘器地图卡开源项目使用教程

lovelace-xiaomi-vacuum-map-cardThis card provides a user-friendly way to fully control map-based vacuums in Home Assistant. Supported brands include Xiaomi (Roborock/Viomi/Dreame/Roidmi/Valetudo/Valetudo RE), Neato, Wyze, Roomba, Ecovacs (and probably more).项目地址:https://gitcode.com/gh_mirrors/lo/lovelace-xiaomi-vacuum-map-card

1. 项目目录结构及介绍

该项目位于GitHub上，地址是 https://github.com/PiotrMachowski/lovelace-xiaomi-vacuum-map-card。下面是对主要目录和文件的简介：

• src: 包含核心的源代码文件，其中xiaomi_vacuum_map_card.js是主要的JavaScript文件，实现地图卡片的功能。
• images: 存放项目相关的图标或示例图片，用于文档说明或用户界面展示。
• README.md: 项目的主读我文件，包含了快速入门指南、安装步骤等基本信息。
• LICENSE: 许可证文件，说明了项目的使用权限和限制。

2. 项目的启动文件介绍

对于这个开源项目，没有一个传统意义上的“启动文件”，因为它的应用集成在Home Assistant这样的智能家居平台中。关键的“启动”或配置过程涉及将xiaomi_vacuum_map_card.js引入到您的Home Assistant的自定义卡片配置中。具体来说，您需要在 Lovelace UI 中通过编辑模式添加该卡片，而非直接执行某个文件。

3. 项目的配置文件介绍

配置小米吸尘器地图卡主要是修改Lovelace UI的资源或者直接在.storage/custom_cards（取决于Home Assistant的配置方式）中创建或编辑配置文件。以下是一个基本的配置示例，展示如何在Lovelace中加入此卡片：

resources:
  - type: module
    url: /local/xiaomi_vacuum_map_card.js

views:
  - title: 家庭地图
    cards:
      - type: 'custom:xiaomi-vacuum-map-card'
        entity: vacuum.device_name  # 替换为您的小米吸尘器实体ID

在这个例子中，首先通过resources部分将xiaomi_vacuum_map_card.js作为模块加载，然后在视图中通过定制卡片类型'custom:xiaomi-vacuum-map-card'来使用它，并指定相应的吸尘器实体ID。

请注意，实际配置可能需要根据您的Home Assistant环境以及项目最新版本的更新进行适当的调整。记得查看项目的README.md文件以获取最新的配置指导。

lovelace-xiaomi-vacuum-map-cardThis card provides a user-friendly way to fully control map-based vacuums in Home Assistant. Supported brands include Xiaomi (Roborock/Viomi/Dreame/Roidmi/Valetudo/Valetudo RE), Neato, Wyze, Roomba, Ecovacs (and probably more).项目地址:https://gitcode.com/gh_mirrors/lo/lovelace-xiaomi-vacuum-map-card