Home Assistant 气候设备目标湿度设置climate.set_humidity动作Action完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文围绕 Home Assistant 文档仓库中 climate.set_humidity 动作文档 展开系统讲解如何通过该内置动作Action即 Service设置空调、除湿机、加湿器、新风系统等气候设备的目标湿度。你将掌握从 UI 可视化配置到 YAML 手写自动化的完整方法理解humidity参数与 Targets 目标的语义并得到一个空气干燥自动提升湿度的真实自动化范例可直接复制到自己的配置中运行。动作是什么一句话理解climate.set_humidityclimate.set_humidity是 Home Assistantclimate领域domain下的标准动作其作用是设置气候设备的目标湿度target humidity。例如当你希望把客厅的相对湿度维持在舒适区间一般建议 40%–60%时就可以用这个动作把目标湿度写到设备上设备随后会自动启停加湿或除湿功能来逼近该目标值。从文档仓库的 YAML front matter 可以看出它的元信息定义在 climate.set_humidity.markdown 中--- title: Set thermostat target humidity action: climate.set_humidity domain: climate description: Sets the target humidity of a climate device. related_actions: - climate.set_temperature - climate.set_hvac_mode ---其中domain: climate说明该动作属于气候域related_actions声明了与温度设定climate.set_temperature和 HVAC 模式切换climate.set_hvac_mode的关联关系——这三者共同构成了对一台气候设备的完整控制面。通过 UI 配置该动作无需编写 YAML如果你更习惯可视化搭建自动化Home Assistant 会在界面中逐步引导你完成配置无需任何 YAML 知识。根据文档 Using this action from the user interface 与具体操作步骤流程如下进入设置Settings 自动化与场景Automations scenes。打开一个已有的自动化或脚本或选择创建自动化Create automation 创建新自动化Create new automation。如果是新建自动化在When何时区域添加一个触发器脚本Script不需要触发器——它们由其他自动化或手动方式调用时才运行。在Then do然后做区域选择添加动作Add action。选择要控制的设备。在目标By target下详见下文 目标Targets选择要控制的气候设备。从该目标可用的动作列表中选择设置恒温器目标湿度Set thermostat target humidity。设置希望应用的湿度Humidity数值。点击保存Save。UI 中的可选参数界面中仅暴露一个核心输入项定义见文档的{% options_ui %}块参数说明Humidity湿度目标湿度以百分比percentage表示。在 YAML 中使用该动作如果你直接编写 YAML或想确切了解 Home Assistant 在底层做了什么文档通过 actions/yaml_header.md 提供了完整的技术参考——包括字段名、类型与必填性。基础示例YAML 中该动作的调用名就是climate.set_humidity一个基础示例如下action: climate.set_humidity target: entity_id: climate.living_room data: humidity: 50这段配置的作用是将climate.living_room的目标湿度设置为 50%。YAML 参数参考{% options_yaml %}块明确定义了唯一的参数字段字段类型必填说明humidityinteger整数是required: true目标湿度以百分比表示。注意humidity是该动作唯一且必填的数据字段——与 climate.set_temperature 拥有temperature/target_temp_high/target_temp_low/hvac_mode多个可选字段不同climate.set_humidity的参数面非常精简。目标Targets详解文档通过 actions/targets.md 统一说明所有动作的目标机制。climate.set_humidity必须指定目标target——目标是动作的作用对象你可以把动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后的每一个匹配的climate实体执行该动作实体Entity一个具体的climate实体例如climate.living_room。设备Device属于某台设备的所有climate实体。区域Area某个房间或区域内的所有climate实体。楼层Floor某一楼层上的所有climate实体。标签Label共享某个标签的所有climate实体。你还可以在一次动作中组合不同的目标类型例如同时指定一个具体实体和一个区域让动作一次性作用于两者。实战示例空气变干时自动提升湿度文档中附带了一个真实场景自动化当室内实测湿度降得过低时把气候设备的目标湿度调高。业务逻辑如下触发器Trigger室内湿度降到 35% 以下动作Action设置恒温器目标湿度目标Target客厅恒温器湿度Humidity50对应的完整 YAML 自动化可直接复制并替换实体 IDautomation: - alias: Raise the living room humidity when the air gets dry triggers: - trigger: numeric_state entity_id: sensor.living_room_humidity below: 35 actions: - action: climate.set_humidity target: entity_id: climate.living_room data: humidity: 50这里的numeric_state触发器监听湿度传感器sensor.living_room_humidity当数值低于 35 时触发动作部分把climate.living_room的目标湿度设置为 50。该示例体现了动作在 更丰富的示例More examples 中强调的用法——set_humidity常与湿度传感器联动构成传感器读数 → 设备设定值的闭环控制。Good to know注意事项设备支持前提该动作只对支持设置目标湿度的气候设备生效来自文档 Good to know 一节。并非所有climate实体都暴露湿度设定能力——例如纯加热型暖气片通常只有温度设定点而加湿器、除湿机、支持湿度调节的空调/新风系统才会开放该能力。调用前请确认目标设备的功能。立即测试Try it yourself无需写任何 YAML你也可以直接在运行时验证效果打开设置Settings 工具Tools 动作Actions搜索climate.set_humidity填写字段后点击执行动作Perform action即可在真实实体上观察结果参考 actions/try_it.md。这对快速确认某台设备是否支持湿度设定尤为有用——如果动作列表里根本没有该动作通常意味着设备不支持。相关动作climate.set_humidity通常与以下动作配合使用来自文档 front matter 的related_actions声明climate.set_temperature设置气候设备的目标温度支持单一设定点或 heat/cool 模式下的温度范围。climate.set_hvac_mode切换设备的 HVAC 模式如制热、制冷、自动、除湿等。三者组合起来你就能在一个自动化中完整编排一台气候设备的模式 温度 湿度全套控制逻辑。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考