Home Assistant vacuum.locate 动作详解：让机器人吸尘器“现身“的定位信号调用指南

Home Assistant vacuum.locate 动作详解让机器人吸尘器现身的定位信号调用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 文档中 Locate vacuumvacuum.locate 动作展开讲清如何让迷失在床底、家具后的扫地机播放声音或闪烁灯光帮助你在第一时间找到它。读完后你将掌握如何在自动化 UI 中配置该动作、如何用 YAML 精确指定目标设备、目标target的五种类型实体/设备/区域/楼层/标签以及如何结合 Roomba 的尘盒已满传感器编写一套需要倒尘盒时自动呼叫吸尘器的实战自动化。vacuum.locate 动作是什么Locate vacuum cleanervacuum.locate动作会让吸尘器播放声音或闪烁灯光使你更容易找到它。典型使用场景是机器人跑到了床下、沙发后面或其他一眼看不到的地方——你不想满屋翻找只需让它出声即可。需要特别注意的一点来自原文档Good to know定位信号的具体效果是发声、闪灯还是两者兼有取决于你的吸尘器型号由对应集成和设备本身决定Home Assistant 只负责下发这条指令。在用户界面中使用该动作如果你习惯以可视化方式构建自动化和脚本Home Assistant 会引导你逐步完成配置全程无需 YAML 知识打开Settings Automations scenes打开一个已有自动化或新建一个自动化添加一个动作Add an action搜索Locate vacuum cleaner选择一台或多台吸尘器也可以选择某个区域area或设备组group点击Save保存。UI 表单背后生成的就是下文介绍的 YAML 结构两者可互相印证。在 YAML 中调用该动作如果你直接编写 YAML或者想搞清楚 Home Assistant 底层到底执行了什么本节给出完整的技术参考字段名、字段类型、以及哪些字段必填。基本示例action: action: vacuum.locate target: entity_id: vacuum.upstairs这条动作会让vacuum.upstairs播放它的定位信号。关于目标省略的默认行为如果不写entity_id该动作将作用于系统中所有支持定位的吸尘器。这在全屋所有机器人都报个到的场景下很有用。YAML 可配置选项YAML 有时会提供 UI 上没有的额外选项用于覆盖更复杂的用例。vacuum.locate的选项如下字段说明是否必填类型target要定位的吸尘器、区域或设备否falsemap动作的目标Targets该动作以目标为操作对象。你可以把动作指向单个实体、一个设备、一个区域、一个楼层或一个标签Home Assistant 会对目标背后的每一个匹配的 vacuum 实体执行该动作。目标类型共五种实体Entity某一个具体的 vacuum 实体如vacuum.living_room设备Device属于该设备的所有 vacuum 实体区域Area某个房间/区域内的所有 vacuum 实体楼层Floor某一层楼上的所有 vacuum 实体标签Label共享同一标签的所有 vacuum 实体。还支持在同一个动作中混合选择不同目标类型。例如同时添加一个具体实体和一个区域作为目标让动作一次性作用于两者。实战示例尘盒已满时自动定位吸尘器这是原文档给出的完整自动化示例值得深入拆解部分吸尘器集成会暴露一个尘盒已满的二元传感器。以 iRobot Roomba and Braava 集成 为例查阅其集成文档的 Integration entities 一节可以确认该集成提供的传感器列表中包含Bin full尘盒已满如果 Roomba 具备该检测能力这一项见 roomba 集成文档。当吸尘器报告尘盒需要处理时下面的自动化会让它播放定位信号让你快速找到它并清理。触发条件TriggerRoomba 尘盒已满传感器变为on执行动作ActionLocate vacuumvacuum.locate目标Target楼上吸尘器vacuum.upstairsautomation: alias: Locate vacuum when bin is full triggers: - trigger: state entity_id: binary_sensor.roomba_bin_full to: on actions: - action: vacuum.locate target: entity_id: vacuum.upstairs这个例子体现了 vacuum.locate 与其他状态类传感器配合的通用模式任何设备需要人工介入的状态尘盒满、滤网脏、电量异常都可以触发定位信号把机器人从它藏身的角落叫出来。如果你的集成没有暴露尘盒传感器可以检查该集成文档的实体列表确认它实际提供哪些传感器后再选用触发源。自己动手验证Try it yourself想立刻测试该动作而不动 YAML打开Settings Tools Actions开发者工具的动作页搜索vacuum.locate填入字段后选择Perform action——你可以在不写一行 YAML 的情况下在自己的真实实体上观察效果。相关动作以下动作常与vacuum.locate搭配使用仓库中均有对应的独立动作文档Pause cleaningvacuum.pause暂停当前清扫任务例如门铃响时让机器人先停一下Clean areavacuum.clean_area让吸尘器只清扫已映射的指定区域Start cleaningvacuum.start、Stop cleaningvacuum.stop开始/停止清扫Return to basevacuum.return_to_base让吸尘器回到充电座Set fan speedvacuum.set_fan_speed调整吸力档位Turn on / Turn offvacuum.turn_on / vacuum.turn_off开关机控制。如果配置过程中遇到问题Home Assistant 的社区Discord、社区论坛、subreddit都欢迎带上你调用的具体动作和预期行为来提问也可以把需求用自然语言描述给 AI 助手请它解释或推荐合适的动作。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考