Xiaomi Cloud Map Extractor自定义组件在Home Assistant中的使用教程

Xiaomi Cloud Map Extractor自定义组件在Home Assistant中的使用教程

Home-Assistant-custom-components-Xiaomi-Cloud-Map-ExtractorThis custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame) vacuums without a need for rooting.项目地址:https://gitcode.com/gh_mirrors/ho/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor

项目介绍

Xiaomi Cloud Map Extractor是专为Home Assistant设计的一个开源项目，旨在从小米扫地机器人的云端提取清洁地图，并将其集成到Home Assistant中展示。该项目允许用户可视化小米系列扫地机器人的清扫路径图，提供了对地图数据的高级控制与显示功能，无需依赖第三方服务，增加了智能家居系统的集成度和用户体验。

项目快速启动

安装步骤：

1. 确保环境：首先确认你的Home Assistant已升级至支持自定义组件的版本。

2. 克隆仓库： 在你的Home Assistant配置目录下的custom_components文件夹内创建一个新的文件夹名为xiaomi_cloud_map_extractor（如果该文件夹不存在）。然后通过SSH或者直接在宿主机操作，运行以下命令来克隆仓库：

   git clone https://github.com/PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor.git xiaomi_cloud_map_extractor
   

3. 配置YAML文件： 编辑Home Assistant的configuration.yaml文件，加入以下配置示例：

   vacuum:
     - platform: xiaomi_cloud_map_extractor
       username: "你的小米账号"
       password: "你的密码"
       country: "cn"  # 根据你的账户地区调整，例如中国为'cn'
   

4. 重启Home Assistant：完成上述配置后，重新启动Home Assistant以加载新组件。

5. 查看地图：重启完成后，在Home Assistant的界面中你应该能够看到小米扫地机器人生成的地图。

应用案例和最佳实践

• 地图显示定制：利用Home Assistant的 Lovelace UI 面板，你可以将小米机器人地图作为一个卡片添加到首页，便于实时监控清扫状态。
• 自动化场景：结合自动化规则，可以基于地图数据触发其他设备动作，比如当某区域被清扫完毕时，自动开启空气净化器。

典型生态项目

与Xiaomi Cloud Map Extractor搭配使用的典型生态项目包括但不限于：

• Lovelace UI 自定义卡片：如使用glance-card或特定的清洁地图卡，以便于更美观且实用地展示地图信息。
• 自动化与脚本：整合家居自动化系统，通过地图数据实现条件触发，例如根据地图上的已清扫区域来调整照明或空调设置，提升智能体验。
• 家庭环境分析：结合环境传感器数据，分析清扫模式与室内空气质量的关系，优化清洁计划。

请注意，使用自定义组件可能不总是稳定无误，保持关注项目更新以获取最新特性和修复。

Home-Assistant-custom-components-Xiaomi-Cloud-Map-ExtractorThis custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame) vacuums without a need for rooting.项目地址:https://gitcode.com/gh_mirrors/ho/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor