企业官网建设流程全解析

Home Assistant 中 Nexia 恒温器加湿设定点操作（nexia.set_humidify_setpoint）完整指南

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

本指南围绕 Home Assistant 官方文档中定义的nexia.set_humidify_setpoint操作，讲解如何在 Nexia、American Standard 与 Trane 恒温器上设置加湿目标值，覆盖 UI 可视化配置、YAML 手工编写、目标（target）选择与参数约束，并结合本仓库中的 Nexia 集成文档与相关操作文档，帮助你快速把"室内湿度控制"接入自动化与脚本中。读完本文，你将能够在自动化、脚本甚至开发者工具中直接调用该操作，并正确理解其作用范围与取值范围。

操作概览：一次设置，全区域生效

nexia.set_humidify_setpoint用于在Nexia、American Standard 或 Trane 恒温器上设置"加湿设定点"（humidify setpoint），即恒温器在室内湿度低于该阈值时启动加湿的目标百分比。

需要特别注意的是：该设置会同时作用于同一恒温器下的所有分区（zone）。如果你的系统是多分区（multi-zone）配置，调用一次操作即可统一调整各分区的加湿目标，无需逐区下发。这一行为与同属一组的nexia.set_dehumidify_setpoint（除湿设定点）、nexia.set_aircleaner_mode（空气净化模式）一致，相关定义可在 nexia.set_humidify_setpoint 操作文档 中确认。

使用前提：先完成 Nexia 集成

该操作隶属于nexia域，使用前需要先通过配置流程（Config Flow）接入 Nexia 云服务。根据 Nexia 集成文档，该集成具备以下关键特征：

• IoT 类别：Cloud Polling（云轮询），即通过互联网轮询厂商 web 服务获取状态；
• 引入版本：0.108；
• 支持型号：TraneXL1050、XL850、XL824；American StandardAZONE1050、AZONE850、ACONT824已有报告可用；
• 不支持型号：XL624、XL950、AZONE950、AZEMT500、AZEMT400B；
• 覆盖平台：binary_sensor、climate、sensor、scene、switch、number 等。

其中，加湿/除湿相关操作都作用在climate实体上（例如climate.downstairs）。接入后，集成还会为每个恒温器生成Relative Humidity（相对湿度）传感器，以及 Zone Temperature、Zone Setpoint Status 等分区级传感器，可作为后续判断"是否需要加湿"的触发数据来源。

从用户界面调用操作

如果你倾向于可视化构建自动化，Home Assistant 会逐步引导完成配置。根据 UI 操作说明 与操作文档中的步骤，过程如下：

1. 进入Settings > Automations & scenes（设置 > 自动化与场景）；
2. 打开一个现有的自动化或脚本，或选择Create automation>Create new automation；
3. 若是新建自动化，需先在When（何时触发）区域添加触发器；脚本不需要触发器，由其他自动化调用时执行；
4. 在Then do（然后执行）区域点击Add action（添加操作）；
5. 在By target（按目标）下选择要控制的恒温器（关于 target 的详细说明见下文"目标（Targets）"一节）；
6. 从该目标可用的操作中选择Nexia: Set humidify setpoint；
7. 设置Humidity（湿度）数值；
8. 点击Save（保存）。

UI 中的选项

UI 模式下仅有一个必填选项：

在 YAML 中调用操作

若你直接编写 YAML，或在 Blueprint、脚本中复用配置，请以nexia.set_humidify_setpoint作为操作名。操作文档给出的基础示例如下：

action: nexia.set_humidify_setpoint target: entity_id: climate.downstairs data: humidity: 35

该示例将climate.downstairs的加湿设定点设置为 35%。

YAML 参数说明

参数定义与类型说明参见 操作文档的 YAML 选项段 以及 YAML 技术参考说明。在编写 YAML 时，字段名必须严格使用humidity，并确保取值落在 10–45 的合法区间内。

在自动化/脚本中组合使用

加湿设定点通常与除湿设定点搭配，形成完整的湿度控制策略。与本文操作互为关联的操作还包括：

• nexia.set_dehumidify_setpoint：设置除湿设定点，取值范围 35–65，同样全分区生效；
• nexia.set_aircleaner_mode：设置空气净化模式（auto、quick、allergy）；
• nexia.set_hvac_run_mode：设置运行模式（permanent_hold/run_schedule）与 HVAC 模式（auto/cool/heat）。

例如，一个根据室内湿度自动切换加湿/除湿目标的自动化可以这样组织（示意，需自行补充触发器与条件）：

action: nexia.set_humidify_setpoint target: entity_id: climate.downstairs data: humidity: 40

目标（Targets）说明

该操作必须指定目标，目标是操作作用的对象。根据 Targets 说明，你可以把目标指向单个实体、设备、区域、楼层或标签，Home Assistant 会对目标背后的每一个匹配 climate 实体执行该操作：

• 实体（Entity）：单个 climate 实体，如climate.living_room；
• 设备（Device）：属于某设备的所有 climate 实体；
• 区域（Area）：某个房间/区域内的所有 climate 实体；
• 楼层（Floor）：某个楼层上的所有 climate 实体；
• 标签（Label）：共享同一标签的所有 climate 实体。

你还可以在同一操作中混合不同目标类型，例如同时添加一个具体实体和一个区域，让操作对二者一并生效。由于该操作的设定是"全分区生效"，结合多区域目标使用时请留意：所有被目标命中的恒温器都会被统一设置加湿目标。

实践要点

• 作用范围：一次调用影响同一恒温器下的所有分区，配置时无需对每个分区重复调用；
• 取值范围：humidity合法区间为 10–45（加湿）、35–65（除湿），越界取值可能被恒温器拒绝或忽略；
• 数据来源：可结合集成生成的Relative Humidity传感器以及 RoomIQ 湿度传感器（若设备支持 RoomIQ）构造触发条件，RoomIQ 相关传感器默认禁用，需在实体设置中手动启用，且启用后每次数据刷新可能增加 5–40 秒延迟与额外网络流量，详见 Nexia 集成文档；
• 快速验证：前往Settings > Tools > Actions（设置 > 工具 > 操作）搜索nexia.set_humidify_setpoint，填写字段后点击Perform action（执行操作），即可在真实实体上即时观察效果，无需编写任何 YAML，参见 Try it yourself。

排查与进一步阅读

若操作未按预期生效，建议依次检查：目标是否指向正确的 climate 实体、humidity是否落在 10–45 范围内、恒温器型号是否在支持列表内、以及集成是否能正常轮询 Nexia 云服务（Cloud Polling 依赖网络连通性）。更多社区排障渠道可参考 Still stuck 说明。完整的前置集成说明（支持型号、传感器列表、RoomIQ 配置等）见 Nexia 集成文档，关联操作列表见 Related actions 生成逻辑。

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io