为什么选择这个集成方案？
传统的 Xiaomi 集成存在地图请求次数限制，而这个定制化方案完美解决了这个问题。通过本地网络通信，你可以同时使用官方 APP 和 HomeAssistant，无需在两者之间做出妥协。
核心优势：
- 🚫 无地图请求限制
- 📱 可与官方 APP 并行使用
- 🗺️ 内置实时地图显示
- 🔧 丰富的自定义服务
第一步：快速安装集成插件
通过 HACS 安装（推荐）
- 打开 HomeAssistant 的 HACS 集成
- 添加自定义仓库
- 搜索"Roborock"并下载安装
- 重启 HomeAssistant 服务
重要提示： 确保你的 HomeAssistant 实例能够在 58866 端口接收设备广播，并能在 58867 端口与设备通信。
配置网络环境
为了让集成正常工作，你需要确保以下网络配置：
- 开放 UDP 端口 58866 用于设备发现
- 允许 TCP 端口 58867 用于设备控制
- 确保 HomeAssistant 与扫地机器人在同一局域网内
第二步：完成设备认证与连接
安装完成后，按照以下步骤完成设备配置：
- 进入"设置"→"设备与服务"
- 点击"添加集成"
- 搜索"Roborock"
- 输入你在 Roborock APP 中使用的用户名
- 提交后，你将收到包含验证码的邮件
- 输入验证码完成认证
小贴士： 如果遇到连接问题，尝试刷新浏览器页面或重启 HomeAssistant 服务。
第三步：充分利用丰富功能
基础清洁控制
- 启动/停止清扫：一键控制扫地机器人工作状态
- 暂停功能：临时中断当前清扫任务
- 回充指令：让设备自动返回充电座
- 风速调节：根据清洁需求调整吸力强度
- 定点清洁：针对特定区域进行重点清扫
高级控制服务
通过自定义服务，你可以实现更精细的控制：
远程遥控模式：
- 启动远程控制：
vacuum_remote_control_start - 移动控制：
vacuum_remote_control_move - 停止远程控制：
vacuum_remote_control_stop
区域清洁功能：
- 指定区域清洁：
vacuum_clean_zone - 分段清洁：
vacuum_clean_segment - 精确导航：
vacuum_goto
实时状态监测
集成提供了全面的传感器数据，让你随时掌握设备状态：
- 清洁统计：当前清洁时长、清洁面积、累计数据
- 设备健康：主刷、边刷、滤网剩余寿命
- 电池信息：实时电量监测
- 工作状态：勿扰模式、错误提示
