Roborock Integration for Home Assistant 教程

---

项目介绍

此项目提供了一个Home Assistant的自定义集成，专门用于连接和管理您的Roborock设备。它允许您通过Home Assistant平台控制您的Roborock扫地机器人，无需频繁依赖Roborock原生应用程序。利用这个插件，您可以实现家庭自动化场景下的更深层次整合，享受更加便捷的智能清洁体验。项目遵循GPL-3.0许可协议，由社区开发者维护，确保了开源精神和技术共享。

项目快速启动

环境准备

确保您的Home Assistant系统满足以下条件：

• 能够与设备在指定端口上进行数据交互。
• 具备与设备建立稳定连接的能力。

安装步骤

1. HACS安装（推荐）

   • 在Home Assistant中安装并配置HACS（Home Assistant Community Store）。
   • 添加本项目仓库到HACS的自定义存储库列表。
   • 搜索"Roborock"并下载该集成。
   • 重启Home Assistant。
   • 进入设置 -> 设备与服务，刷新页面。

2. 集成配置

   • 在Home Assistant的配置界面，点击"添加集成"。
   • 搜索并选择"Roborock"，继续操作。
   • 输入Roborock App中的用户名，提交。
   • 查收验证邮件，输入验证码并确认。

注意事项

首次安装或更新后记得重新加载前端以应用更改。

应用案例和最佳实践

• 自动化清扫任务：结合Home Assistant的时间触发器或者传感器（如人离开家时），自动派遣Roborock开始清扫任务。
• 区域限制清扫：利用Home Assistant的区域划分功能，指定机器人仅清扫特定房间或区域。
• 语音控制：通过集成Google助手或Amazon Alexa，使用语音命令控制扫地机器人的启停。
• 地图可视化：如果您的Roborock型号支持，可以通过Xiaomi Cloud Map Extractor等组件显示清扫地图。

典型生态项目

• Home Assistant与IoT设备联动：将Roborock清扫任务与灯光控制、温湿度监测等其他智能家居设备联动，创建综合的智能生活场景。
• 家庭安全功能：对于配备了环境感知功能的Roborock机型，可以探索将其数据接入智能家居系统，实现更全面的家庭管理。
• 高级自动化脚本：利用Home Assistant的脚本和自动化功能，实现基于复杂逻辑的清扫方案，例如基于天气预报自动调整清扫模式。

结束语：通过以上步骤，您即可开始享受Roborock与Home Assistant相结合带来的智能家居便利。记住，随着Home Assistant的不断迭代，保持插件的更新是确保功能完整的关键。