Home Assistant 中 vacuum.start_pause 动作详解一个指令启动、暂停或恢复扫地机清洁【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文以 Home Assistant 官方用户文档仓库中vacuum.start_pause动作文档为主体完整讲解该动作的作用场景、界面与 YAML 两种配置方式、可用的 target 目标类型与参数说明并给出可直接复用的自动化示例读完后你将能够用一个状态感知的单一动作替代先判断再分支的写法在自动化与脚本中灵活控制支持 start/pause 的扫地机。动作定位为什么需要 vacuum.start_pausevacuum.start_pause界面显示名为Start/pause vacuum cleaner是 Home Assistant 面向vacuum域提供的动作其定义为启动、暂停或恢复一个受支持扫地机当前的清洁任务见 动作文档 头部 frontmatteraction: vacuum.start_pause、domain: vacuum。它解决的核心问题是状态未知时的单一控制当你希望用一个动作覆盖空闲→启动和运行中→暂停两种情况而不必先查询扫地机当前处于 idle、docking 还是 cleaning 状态时就应使用这个动作。动作的实际效果取决于扫地机当前状态扫地机空闲/停泊在底座执行后开始清洁扫地机正在清洁执行后暂停扫地机已暂停执行后恢复清洁。这与需要明确意图的相邻动作形成互补均可在本仓库 source/_actions/ 目录下找到对应文档动作行为适用场景vacuum.start仅启动或恢复清洁定时开扫、离家后自动开扫意图明确为开始vacuum.pause仅暂停当前任务门铃响起、有人入睡时临时让扫地机停下vacuum.toggle切换电源开/关状态一个按钮翻转开关状态不关心是否在清洁vacuum.start_pause启动 / 暂停 / 恢复三态合一一个按钮或指令按当前状态自适应处理在用户界面中使用如果偏好可视化搭建自动化与脚本Home Assistant 会在界面上逐步引导完成该动作的配置无需编写 YAML。操作路径来自 动作文档 及 界面使用说明进入Settings Automations scenes设置 自动化与场景打开或新建一条自动化添加动作搜索Start/pause vacuum cleaner选择要控制的扫地机实体、区域或设备选择Save保存。在 YAML 中使用直接在 YAML 中编写可以更精确地控制动作行为也是理解 Home Assistant 底层执行方式的参考见 YAML 使用说明。最小可用示例action: action: vacuum.start_pause target: entity_id: vacuum.downstairs该示例会根据vacuum.downstairs的当前状态启动、暂停或恢复其清洁任务。entity_id目标为可选省略时命令会发送给所有目标范围内的受支持扫地机。target也接受其他目标类型可一次指定多个不同类型的目标例如一个具体实体加一个区域Home Assistant 会对所有匹配实体执行该动作。YAML 参数说明YAML 相比界面可能提供更多面向复杂场景的选项。vacuum.start_pause的完整参数表如下源自 动作文档 中的 options 定义参数描述必填类型target要控制的扫地机、区域或设备否map映射目标target类型根据仓库内动作文档共享的 目标说明该动作支持把目标指向以下任意对象Home Assistant 会对该目标背后所有匹配的vacuum实体执行动作Entity实体某一个具体实体例如vacuum.living_roomDevice设备属于某台设备的所有vacuum实体Area区域某个房间/区域内的所有vacuum实体Floor楼层某个楼层上的所有vacuum实体Label标签共享同一标签的所有vacuum实体。不同目标类型还可以在同一条动作中混用实现跨实体、跨区域的批量控制。实战自动化一个辅助按钮统一控制启动与暂停文档给出的完整自动化示例用一个辅助按钮helper button作为唯一入口——扫地机空闲时按下即启动清洁正在运行时按下即暂停。触发器辅助按钮被按下动作启动或暂停清洁vacuum.start_pause目标楼下扫地机automation: alias: Start or pause vacuum triggers: - trigger: state entity_id: input_button.vacuum_start_pause actions: - action: vacuum.start_pause target: entity_id: vacuum.downstairs这里触发器使用了state触发监听input_button实体的状态变化动作端仅一个vacuum.start_pause调用即可覆盖启动与暂停两种意图无需在 YAML 中编写if/else条件分支判断扫地机当前状态。调试与验证文档建议在正式写入自动化前先在开发工具中验证打开Settings Tools Actions开发者工具 动作搜索vacuum.start_pause填入目标字段后点击Perform action即可在不写任何 YAML 的情况下对真实实体执行并观察结果该说明来自共享的 try_it 片段。需要注意的边界该动作仅对支持 start/pause 控制的扫地机生效具体扫地机是否支持取决于其集成integration实现的start与pause服务。相邻动作的边界条件同样值得留意例如 vacuum.pause 文档 指出部分扫地机在非清洁中状态可能不支持暂停——这正说明为何状态自适应场景应优先选择vacuum.start_pause。若动作未按预期工作可参考文档中的求助渠道将所调用的动作及预期行为提供给社区Discord、社区论坛等或向 AI 助手描述需求以获得动作选择建议见共享的 stuck 说明。小结vacuum.start_pause是 Home Assistantvacuum域中状态自适应的清洁控制动作一个动作、一个target参数实体/设备/区域/楼层/标签均可即可在启动、暂停、恢复三种语义间按扫地机当前状态自动切换。适合用于辅助按钮一键控制、定时任务中免判断的清洁调度等场景对于意图单一的启动或暂停需求则应选用 vacuum.start 或 vacuum.pause。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考