Home Assistant homematicip_cloud.activate_vacation 动作实战指南定时开启 Homematic IP 假期模式【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇指南围绕 Home Assistant 官方文档中的homematicip_cloud.activate_vacation服务动作展开它让 Homematic IP 接入点Access Point进入假期模式vacation mode在指定结束时间前维持一个目标温度到点自动关闭。读完本文你将掌握该动作在可视化界面UI与 YAML 两种写法下的完整配置方式、每个选项的取值要求与格式约束以及如何配合deactivate_vacation等关联动作构建“假期模式开/关”的完整自动化闭环。动作概览它做什么、不做什么根据动作文档 source/_actions/homematicip_cloud.activate_vacation.markdown 的前置元数据front matter元数据字段值含义actionhomematicip_cloud.activate_vacationYAML 中调用的服务名domainhomematicip_cloud所属集成域descriptionActivates the vacation mode until a given time.将假期模式保持到指定时间related_actionsdeactivate_vacation、activate_eco_mode_with_period、deactivate_eco_mode配套使用的关联动作动作的行为语义是开启Homematic IP 接入点的假期模式并持续到你选定的日期和时间期间维持一个目标温度temperature to hold到该时刻后假期模式会自动关闭无需再发一条关闭指令。一个重要的边界事实该动作不支持目标targets。在 UI 中你不会看到选择区域area、设备device、实体entity或标签label的提示框——它直接作用于接入点本身。多个接入点的场景通过accesspoint_id选项区分而不是通过实体目标。前置条件Homematic IP Cloud 集成该动作依赖 HomematicIP Cloud 集成。从集成的 front matter 可以看到它是hub类型、ha_iot_class为Cloud Push通过云端推送通信、自 0.66 版本起内置、支持配置流ha_config_flow: true即推荐通过Settings Devices Services的 UI 配置流程添加。理解假期模式的语境先看集成文档的关键事实该集成是 Homematic IP 云端服务器的接口由于官方没有公开 API 文档其功能基于逆向工程实现原文提醒 Use at your own risk支持 Alarm、Climate、Cover、Light、Lock 等多种设备平台。文档中反复出现的SGTINSerialized Global Trade Item Number序列化全球贸易项目编号就是接入点的身份标识。如果采用手动 YAML 方式配置集成写法如下引自集成文档homematicip_cloud: - accesspoint: IDENTIFIER # 接入点的 SGTIN authtoken: AUTHTOKEN # 用 hmip_generate_auth_token.py 生成的认证令牌 - name: Location2 # 可选用于设备名称前缀多接入点时很有用 accesspoint: IDENTIFIER2 authtoken: AUTHTOKEN2这里有一个与本文动作直接相关的推断集成支持多个接入点同时接入这正是activate_vacation动作提供可选accesspoint_id选项的原因——单接入点可省略多接入点时必须指定 SGTIN 才能明确操作对象。在用户界面UI中使用偏好可视化方式时可按以下步骤在自动化或脚本中加入该动作进入Settings Automations scenes。打开一个已有的自动化或脚本或选择Create automation Create new automation。若是新建自动化先在When部分添加触发器trigger脚本不需要触发器由其他组件调用时运行。在Then do部分点击Add action。在搜索框中搜索并选择HomematicIP Cloud: Activate vacation。设置Endtime假期模式自动关闭的时刻与Temperature假期期间维持的温度。点击Save保存。UI 中的选项选项说明必填Endtime假期模式应自动关闭的时间格式为YYYY-MM-DD HH:MM是Temperature假期模式期间维持的设定温度是Access point IDHomematic IP 接入点的 IDSGTIN。只有一个接入点时可留空否注意Endtime的格式约束YYYY-MM-DD HH:MM日期与时间必须连写在一个字符串里例如2019-09-17 18:00。在 YAML 中使用在 YAML 中该动作的调用名为homematicip_cloud.activate_vacation。文档给出的最小示例action: | action: homematicip_cloud.activate_vacation data: endtime: 2019-09-17 18:00 temperature: 18.5其效果开启假期模式直至2019-09-17 18:00期间维持 18.5°C。YAML 选项说明字段类型必填说明endtimestring是假期模式自动关闭的时间格式YYYY-MM-DD HH:MM。建议加引号避免 YAML 把日期解析成日期对象temperaturefloat是假期模式期间维持的设定温度如18.5accesspoint_idstring否接入点的 SGTIN只有一个接入点时可省略在完整自动化中一个典型的离家开假期模式写法是把该动作放进action列表。Home Assistant 的自动化数据值支持模板表达式templating因此endtime可以动态计算例如出发时开启、三天后 18:00 自动结束automation: - alias: 离家开启假期模式 trigger: - platform: state entity_id: person.全家 to: not_home for: hours: 2 action: - action: homematicip_cloud.activate_vacation data: endtime: {{ (as_timestamp(now()) 3 * 86400) | date(%Y-%m-%d) }} 18:00 temperature: 16.0上面的自动化结构展示了触发条件与动作的完整写法模板表达式属于 Home Assistant 自动化的通用机制endtime最终仍必须渲染为YYYY-MM-DD HH:MM格式的字符串。请根据实际实体 ID 调整trigger部分。用开发者工具快速验证不需要写任何 YAML 就能试跑该动作打开Settings Tools Actions开发者工具搜索homematicip_cloud.activate_vacation填入endtime、temperature以及多接入点时的accesspoint_id点击Perform action。执行后你的真实接入点会立即进入假期模式可用于在正式写入自动化前先验证参数与预期行为是否一致。关联动作假期模式与节能模式的开/关闭环动作 front matter 中声明了三个related_actions它们与activate_vacation共同构成 Homematic IP 的两种离房模式控制族。以下说明均取自对应文档1.homematicip_cloud.deactivate_vacation立即关闭假期模式见 source/_actions/homematicip_cloud.deactivate_vacation.markdown。它与activate_vacation互补无论当初设置了什么结束时间执行后立即关闭假期模式。UI 中的动作名是HomematicIP Cloud: Deactivate vacation且没有任何必填参数。action: | action: homematicip_cloud.deactivate_vacation data: accesspoint_id: SGTIN-XXX # 可选仅多接入点时需要由此可以构建一个实用的闭环出发时activate_vacation带兜底结束时间回家时触发器再调deactivate_vacation提前退出避免温度设定被保留到原定的结束时刻。2.homematicip_cloud.activate_eco_mode_with_period定时开启节能模式见 source/_actions/homematicip_cloud.activate_eco_mode_with_period.markdown。行为与假期模式类似——开启节能模式eco mode到指定时间后自动关闭——但不持有温度因此少一个temperature参数action: | action: homematicip_cloud.activate_eco_mode_with_period data: endtime: 2019-09-17 18:00YAML 选项只有endtimestring必填YYYY-MM-DD HH:MM与accesspoint_idstring可选。3.homematicip_cloud.deactivate_eco_mode关闭节能模式用于与节能模式系列动作配对语义即立即退出节能模式与假期系列的deactivate_vacation形成对称。假期模式 vs 节能模式如何选维度假期模式vacation节能模式eco动作名activate_vacationactivate_eco_mode_with_period持有目标温度是temperature必填否典型场景长期离家维持防冻/舒适温度短期外出仅降低能耗立即关闭deactivate_vacationdeactivate_eco_mode两者都不支持 targets多接入点场景同样依赖各自的accesspoint_id/ UI 中的 Access point ID 选项。文档结构补充该页面如何从源码渲染结合本仓库的构建结构可以看出该动作文档的组成部分正文用{% include %}引入通用片段 source/_includes/actions/ui_header.mdUsing this action from the user interface 一节、yaml_header.mdUsing this action in YAML 一节、try_it.mdTry it yourself 一节与 stuck.md求助渠道一节。其中 related.md 会遍历 front matter 的related_actions列表在站点数据site.actions中按action字段匹配每个关联动作生成Related actions链接列表——这就是本文关联动作章节的数据来源。动作选项表格则分别由{% options_ui %}与{% options_yaml %}标签块渲染选项的required、type等字段即上表内容的定义处。_actions/目录下的这类 Markdown 文件是站点动作页面的数据源渲染后的动作索引入口位于 source/actions/index.html。小结homematicip_cloud.activate_vacation的作用域是接入点整体无 targets核心参数为endtimeYYYY-MM-DD HH:MM字符串必填与temperaturefloat必填accesspoint_idSGTIN仅在多接入点时需要。假期模式到达endtime后自动关闭如需提前退出调用deactivate_vacation无需必填参数。短期节能需求可改用activate_eco_mode_with_period不带温度保持。上线自动化前建议先通过 Settings Tools Actions 用开发者工具实跑一次确认接入点状态变化符合预期。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考