Home Assistant humidifier.turn_on 动作详解用 UI、YAML 与自动化开启加湿器【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.iohumidifier.turn_on是 Home Assistant 用于开启加湿类设备的核心动作可在自动化、脚本中调用一键启动加湿器、除湿机或湿度控制器的运行。本文基于官方文档仓库中该动作的完整参考页覆盖其界面操作步骤、YAML 语法、目标target类型、开发者工具验证方式与典型自动化场景并结合文档站的实际渲染机制补充实现层面的佐证读完即可在自己的 Home Assistant 环境中直接落地使用。动作概览根据 动作定义文件 的 front matter该动作的关键元信息如下属性值动作名称Turn on humidifier动作 IDhumidifier.turn_on所属域domainhumidifier功能描述Turns on a humidifier开启一个加湿器关联动作humidifier.turn_off、humidifier.toggle、humidifier.set_mode、humidifier.set_humidity官方说明的用途是使用该动作开启加湿器humidifier、除湿机dehumidifier或湿度控制器hygrostat例如让房间开始增加湿度。需要注意的一点是这个动作仅对 humidifier 实体生效Good to know 一节明确指出 “This action only works with humidifier entities”。在用户界面中添加该动作如果你习惯可视化构建自动化和脚本Home Assistant 会逐步引导你完成配置选择目标、保存即可无需编写 YAML。官方文档给出的完整操作步骤为进入Settings Automations scenes设置 自动化与场景打开一个已有的自动化或脚本或选择Create automationCreate new automation如果是新建自动化在When触发条件部分添加一个触发器脚本不需要触发器脚本由其他对象调用时执行在Then do执行动作部分选择Add action选择要控制的对象在By target之下参见下文“目标类型”选中要开启的加湿器在该目标列出的可用动作中选择Turn on humidifier选择Save保存。UI 中的选项该动作除目标target之外没有额外选项——也就是说选对设备后直接保存即可生效无需设置任何参数。YAML 语法与基础示例在 YAML 中该动作以humidifier.turn_on作为引用名。官方文档给出的基础示例如下action: humidifier.turn_on target: entity_id: humidifier.bedroom这条动作的作用就是开启实体humidifier.bedroom。YAML 选项与 UI 一致该动作除target之外没有额外的 YAML 选项。从仓库的站点生成逻辑可以印证这一点doc_collections_data.rb 在构建动作索引 JSON 时只会从页面中的{% options_yaml %}块提取参数字段p字段humidifier.turn_on页面不含该块因此它在动作索引中没有参数字段映射——“无额外选项”在文档站的数据层面得到了一致的体现。相比之下同域的动作humidifier.set_humidity就有必填参数见 set_humidity 文档其data中的humidity为必填整数0–100 的百分比。这说明“turn 类”动作在设计上是零参数的开关型动作参数化的控制如目标湿度由同域其他动作承担。目标Targets of the action类型该动作必须提供目标目标是动作的作用对象。该说明由所有动作页共享的模板 targets.md 渲染针对 humidifier 域的具体含义如下Entity实体某一个具体的 humidifier 实体例如humidifier.living_roomDevice设备属于某个设备的全部 humidifier 实体Area区域某个房间或区域内的全部 humidifier 实体Floor楼层某楼层上的全部 humidifier 实体Label标签共享同一个标签的全部 humidifier 实体。Home Assistant 会对目标背后匹配的每一个 humidifier 实体执行该动作。此外可以在同一个动作里组合多种目标类型例如同时添加一个具体实体和一个区域作为目标动作会同时作用于两者。这一点对批量管理多台加湿器如“开启所有卧室设备的加湿功能”非常实用。用开发者工具直接验证在把动作写入自动化之前官方文档建议先在开发者工具中实测打开Settings Tools Actions开发者工具 动作搜索humidifier.turn_on填写字段后选择Perform action。这样无需写任何 YAML 就能看到动作在你真实实体上的效果。该入口由共享模板 try_it.md 提供是所有动作页统一的验证路径。实战示例每天早上自动开启卧室加湿器官方文档提供了一个完整的自动化示例在固定时间开启加湿器比如在你醒来前开始为房间加湿。触发条件TriggerTime: 07:00时间 07:00动作ActionTurn on humidifier目标Target卧室加湿器对应的完整 YAML 如下triggers/actions为新版自动化 YAML 的键名写法- alias: Turn on the bedroom humidifier in the morning triggers: - trigger: time at: 07:00:00 actions: - action: humidifier.turn_on target: entity_id: humidifier.bedroom按此结构把at: 07:00:00换成你的目标时间、entity_id换成实际的加湿器实体或用area_id、device_id等目标类型即可直接复用。配套动作关闭、切换与设置目标湿度humidifier.turn_on的 front matter 中声明了四个关联动作它们共同构成加湿器域的完整控制面。以下均来自本仓库中对应的动作文档1.humidifier.turn_off关闭加湿器来源turn_off 文档。同样无额外选项典型用法是夜间关闭以降噪- alias: Turn off the bedroom humidifier at night triggers: - trigger: time at: 23:00:00 actions: - action: humidifier.turn_off target: entity_id: humidifier.bedroom2.humidifier.toggle切换加湿器开/关来源toggle 文档。开启时关闭、关闭时开启适合绑定物理按钮其官方示例使用input_button的状态触发- alias: Toggle the bedroom humidifier with a button triggers: - trigger: state entity_id: input_button.humidifier_toggle actions: - action: humidifier.toggle target: entity_id: humidifier.bedroom3.humidifier.set_humidity设置目标湿度来源set_humidity 文档。这是同域中唯一带参数的动作humidity为必填整数0–100 百分比官方示例- alias: Raise the bedroom humidity in the morning triggers: - trigger: time at: 07:15:00 actions: - action: humidifier.set_humidity target: entity_id: humidifier.bedroom data: humidity: 60值得注意的是该文档 “Good to know” 中的限制说明不同设备支持的湿度范围可能比 0–100 更窄超出设备支持范围的动作会失败。这提示在组合使用turn_on与set_humidity时应以设备实际能力为准。注意事项与常见误区仅对 humidifier 实体生效对非 humidifier 域实体如普通的 switch调用该动作不会达到预期这是官方文档明确列出的限制无参数可配不要试图在turn_on的data中传入湿度、模式等参数参数化控制应交给humidifier.set_humidity、humidifier.set_mode等专门动作目标可以批量通过 area/floor/label 目标可一次开启多台设备避免逐台编写entity_id先用开发者工具验证在自动化正式启用前通过Settings Tools Actions实测一次确认目标实体响应正常。文档站实现侧写这个页面是如何生成的对关注文档站本身的读者本页的仓库结构值得了解动作正文位于 source/_actions/humidifier.turn_on.markdown属于 Jekyll 站点配置的actions集合front matter 中的action、domain字段是索引键页面通过 Liquid include 复用共享段落ui_header.mdUI 使用导语、yaml_header.mdYAML 使用导语、targets.md目标类型说明、try_it.md开发者工具验证、more_examples.md更多示例引导与 related.md根据 front matter 的related_actions自动渲染关联动作链接列表doc_collections_data.rb 插件会在构建时把所有动作页扫描为actions_json以domain.name即humidifier.turn_on为键携带描述d、页面 URLu、标题t和参数映射p供前端 prism-doc-links.js 之类的能力在代码块中做动作链接提示由于turn_on页面没有{% options_yaml %}块其索引条目不包含参数映射与“该动作无 YAML 选项”的事实一致全部动作的可搜索总目录由 source/actions/index.html 提供按 domain 分组渲染humidifier 域即包含本文介绍的turn_on及其关联动作。综上humidifier.turn_on是一个“零参数、强目标”的开关型动作掌握target的多种指向方式实体/设备/区域/楼层/标签、开发者工具的验证流程以及与turn_off/toggle/set_humidity的分工就足以构建覆盖加湿器日常场景的完整自动化方案。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考