Home Assistant Whisker 集成litterrobot.set_sleep_mode 动作详解与配置指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 的 WhiskerLitter-Robot集成中litterrobot.set_sleep_mode动作展开讲解睡眠模式的运行机制、在自动化与脚本中的 UI 与 YAML 配置方法、参数含义与适用机型限制帮助你在不打开 Whisker App 的情况下通过 Home Assistant 让猫砂盆在指定时间静音 8 小时。动作概述什么是 Litter-Robot 睡眠模式litterrobot.set_sleep_mode动作Set sleep mode用于开启或关闭 Litter-Robot 的睡眠模式。开启睡眠模式后Litter-Robot 会从你设定的时间点开始连续 8 小时不执行自动清洁循环从而保持安静。这一功能非常实用例如将睡眠模式设置为晚上 10:30 开始就可以保证猫砂盆在夜间或你与猫共处一室时保持静音且无需在 Whisker App 中额外修改设置。睡眠模式的状态可以通过集成提供的Sleep modebinary_sensor与Sleepingbinary_sensor实体观察前者表示睡眠模式是否启用后者表示睡眠模式当前是否处于生效区间。在 Home Assistant 中WhiskerLitter-Robot集成属于 hub 型集成ha_integration_type: hub通过 Whisker 云推送Cloud Push与轮询每 5 分钟获取设备数据集成质量等级为 platinum相关定义见 Whisker 集成文档。前置条件确认集成与目标实体使用该动作前需要满足已通过**配置流Config Flow**添加 Whisker 集成输入 Whisker 账号邮箱与密码并确保账号下已绑定 Wi-Fi 版 Litter-Robot 设备可通过 Whisker App 完成设备绑定。动作的目标实体是集成为每个 Litter-Robot 创建的vacuum域实体默认命名为vacuum.litter_robot_litter_box之类实际名称取决于你的设备命名。集成文档中列出的与睡眠模式直接相关的实体包括实体域说明Sleep modebinary_sensor指示睡眠模式是否已启用Sleepingbinary_sensor指示睡眠模式当前是否处于生效状态Sleep mode start timesensor睡眠模式启用时显示当前或下一次开始时间Sleep mode end timesensor睡眠模式启用时显示当前或最近一次结束时间Litter boxvacuum代表单个 Litter-Robot 单元的主实体即本动作的目标在 UI 中设置睡眠模式要在自动化或脚本中使用该动作进入设置Settings 自动化与场景Automations scenes。打开现有的自动化或脚本如果是新建选择创建自动化Create automation 创建新自动化Create new automation。新建自动化时在When何时部分添加触发器脚本不需要触发器它们由其他自动化或实体调用时执行。在Then do然后执行部分选择添加动作Add action。在搜索框中搜索并选择Litter-Robot: Set sleep mode。在目标Targets下选择要控制的 Litter-Robot 实体。将Enabled启用开关打开或关闭并可选设置Start time开始时间。选择保存Save。目标Targets的取值方式该动作必须有目标target。目标可以指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后匹配的每个vacuum域实体执行动作实体Entity单个具体的vacuum实体如vacuum.litter_robot_litter_box。设备Device属于某个设备的全部vacuum实体。区域Area某个房间或区域内的全部vacuum实体。楼层Floor某个楼层上的全部vacuum实体。标签Label共享同一标签的全部vacuum实体。同一动作内可以混用不同类型的目标例如同时选中一个具体实体和一个区域。UI 中的选项选项是否必填说明Enabled是是否启用睡眠模式Start time否Litter-Robot 进入睡眠模式并阻止自动清洁循环 8 小时的时间点在 YAML 中使用该动作在 YAML 中该动作引用名为litterrobot.set_sleep_mode。action字段也可写作service二者等价。一个基础示例action: litterrobot.set_sleep_mode target: entity_id: vacuum.litter_robot_litter_box data: enabled: true start_time: 22:30:00该示例将睡眠模式开启并从22:30晚上 10 点半起生效。在自动化中完整的写法如下automation: - alias: Enable Litter-Robot sleep mode at night trigger: - trigger: time at: 22:25:00 action: - action: litterrobot.set_sleep_mode target: entity_id: vacuum.litter_robot_litter_box data: enabled: true start_time: 22:30:00YAML 参数详解参数类型必填默认值说明enabledboolean是true是否启用睡眠模式start_timestring否—Litter-Robot 进入睡眠模式并阻止自动清洁循环 8 小时的时间点。使用 24 小时制%H:%M:%S格式秒可省略基于 Home Assistant 时区。例如22:30:00表示晚上 10:30注意事项start_time以 Home Assistant 本地时区为准请勿混用不同时区的时间字符串。秒字段可选22:30:00与22:30均可接受。关闭睡眠模式时enabled: false无需提供start_time。与自动化/脚本配合的典型场景睡眠模式动作最适合与时间触发器组合实现「到点自动静音、8 小时后自动恢复清洁」的效果夜间静音在睡前时间触发enabled: true与start_time确保设备整夜安静。日间安静时段与工作时段触发器配合在你居家办公或会客时临时关闭自动清洁。配合状态实体做条件判断可结合Sleepingbinary_sensor实体状态作为自动化条件避免重复触发。仓库还提供了一份与 Litter-Robot 循环联动打扫的官方蓝图 litterrobot_clean_area_on_cycle.yaml它在 Litter-Robot 的vacuum实体状态变为cleaning时触发调用vacuum.clean_area让扫地机器人清洁指定区域可作为理解该集成vacuum实体与状态流转的参考。机型限制与已知局限睡眠模式调度当前仅适用于 Litter-Robot 3。要在 Litter-Robot 4 上修改睡眠计划需要使用 Whisker App。集成文档的 Known limitations 中明确列出Litter-Robot 4 及更新机型的睡眠计划配置不受支持。Litter-Robot 5 虽然提供了「按天睡眠计划」实体Sleep mode (per day) 开关与 time 域的开始/结束时间实体默认禁用需在实体设置中启用但该能力属于设备本身的实体控制并非本动作的适用范围。睡眠模式相关的开关实体在不同机型上有差异Night light mode仅适用于 Litter-Robot 3Sleep mode (per day)仅适用于 Litter-Robot 5配置前请先确认自己的设备型号。排查与进一步帮助若设备显示不可用通常是因为无法连接 Whisker 云服务先检查网络连接再打开 Whisker App 确认能否控制设备如果 App 也无法连接则可能是 Whisker 服务故障或设备离线。关于该动作的更多疑问可以查阅 Home Assistant 社区论坛或 Discord 获取实时帮助。相关的完整实体清单、数据更新机制与集成卸载方式可参阅 Whisker 集成文档。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考