如何使用
由于这是一个后端集成,它不提供原生的前端 UI 组件。相反,所有的可视化交互都依赖于 Home Assistant 的 Lovelace 仪表盘。




虽然没有内置的前端支持,但该集成导出了完整的一套平台 实体(例如 vacuum、camera、select 和 button 实体)。通过将这些实体与社区开发的自定义 Lovelace 卡片结合使用,完全可以在仪表盘上构建高度交互的自定义 UI。这种方法在 Home Assistant 内提供了完整的、类似应用的体验。


此外,该集成提供了专用的 服务 并广播自定义 事件。这允许通过后台 自动化 完全控制机器人吸尘器,从而实现不依赖任何可视界面的复杂场景。
首先检查这些
如果还不熟悉 Home Assistant,强烈建议查看以下官方文档页面。由于此集成严格遵循标准架构,因此充分理解这些核心概念对于充分利用该集成至关重要:
- 吸尘器实体:解释了核心吸尘器组件。理解这一点对于与主设备实体交互、解释其状态以及使用标准服务调用(例如启动、暂停或返回基座)是必要的。
- 选择、数量 和 按键 实体:详细说明了配置选项和操作的暴露方式。该集成使用数十个这些实体来表示设备设置(例如吸力等级、水量)并执行操作(例如重置耗材、定位机器人)。
- 服务调用:解释了如何使用参数执行后端操作。该概念对于触发集成的自定义服务(例如指定房间或区域的清洁)至关重要。
- 自动化:解释如何自动触发操作。这对于创建后台工作流程是必需的,例如根据自定义事件在房子无人时启动清洁周期。
- 自定义服务 推荐:详细说明特定集成的服务调用,这些调用扩展了标准功能,允许执行高级操作,例如分区清洁和基于区域的清洁。本节提供了用于自动化这些功能的实际服务调用示例和负载。