企业官网建设流程全解析

Home Assistant Nexia 恒温器湿度设定：nexia.set_dehumidify_setpoint动作实战指南

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

本篇技术指南围绕 Home Assistant 文档仓库中的动作参考文档 nexia.set_dehumidify_setpoint 展开，讲解如何通过 UI 与 YAML 两种方式，为 Nexia、American Standard（美标）或 Trane（特灵）智能恒温器设置除湿设定点（dehumidify setpoint）。读完本文，你将掌握该动作的完整字段定义、取值范围、目标（Target）选择机制，以及它与其他 Nexia 湿度/净化类动作的配合方式，可直接在自动化与脚本中落地使用。

动作概述：一个动作控制整台恒温器的除湿目标

nexia.set_dehumidify_setpoint是 Home Assistant 的 Nexia 集成（hub 类型集成，域名为nexia，对应 Nexia/American Standard/Trane 集成文档）提供的一个动作（action）。它用于设置恒温器上的除湿设定点，即当室内湿度高于该百分比时，空调系统启动除湿模式的目标湿度值。

使用该动作时有一个关键行为需要牢记：该设置会同时影响同一台恒温器上的所有分区（zone），并非只作用于当前目标实体所在的分区。这与其姊妹动作nexia.set_humidify_setpoint（加湿设定点，范围 10–45）的行为一致，参见 nexia.set_humidify_setpoint。

该动作的典型应用场景包括：

• 在潮湿季节，根据户外湿度传感器或天气预测自动调整除湿目标；
• 夜间降低除湿设定点，避免空调长时间高负荷运转；
• 离家/回家场景中联动调整湿度控制策略。

在 UI 中配置该动作（无需 YAML）

如果你习惯使用 Home Assistant 的图形化界面，可以完全通过 UI 完成配置。官方文档给出了如下步骤：

1. 进入设置（Settings）> 自动化与场景（Automations & scenes）。
2. 打开一个现有的自动化或脚本；也可以选择创建自动化（Create automation）> 创建新自动化（Create new automation）新建一个。
3. 如果是新建自动化，需要在When（何时）区域添加一个触发器；脚本则不需要触发器——脚本由其他自动化或服务调用时执行。
4. 在Then do（然后执行）区域选择添加动作（Add action）。
5. 选择要控制的设备：在By target（按目标）下（详见下文 动作的目标（Targets））选择你要控制的恒温器。
6. 在该目标可用的动作列表中，选择Nexia: Set dehumidify setpoint。
7. 设置Humidity（湿度）数值。
8. 点击保存（Save）。

UI 中的选项

在 UI 中该动作只有一个必填选项：

在 YAML 中使用该动作（完整参考）

如果你直接编写 YAML，或希望精确掌握 Home Assistant 在底层执行的内容，可以直接以nexia.set_dehumidify_setpoint作为action字段值来调用。文档给出的基础示例如下：

action: nexia.set_dehumidify_setpoint target: entity_id: climate.downstairs data: humidity: 45

上述示例将climate.downstairs的除湿设定点设置为45%。

YAML 字段说明

需要特别说明的是humidity字段的类型为integer（整数），因此请避免传入 45.5 这类浮点值。同时它也是必填项，缺少该字段时动作无法正确执行。

动作的目标（Targets）

与所有 Home Assistant 动作一样，该动作必须指定目标（target）。目标即动作的作用对象，你可以将动作指向单个实体、设备、区域、楼层或标签，Home Assistant 会对匹配到的每一个climate实体执行该动作。可用的目标类型包括：

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

你还可以在同一个动作中混合选择不同类型的目标。例如，将某个具体实体与某个区域同时加入目标，动作就会对这两者一并执行。

需要提醒的是：由于该动作的设置会影响整个恒温器的所有分区，即使你的目标仅指定了其中一个分区实体，其余分区的除湿行为也会一并改变。这是 Nexia 恒温器硬件层面的联动特性。

与其他 Nexia 动作的配合使用

该动作在官方文档中与其他三个 Nexia 动作互为相关动作（见 related actions 配置 中的related_actions字段），它们共同构成了完整的室内空气质量与舒适度控制方案：

这些动作同样作用于整个恒温器（影响所有分区），且都属于 climate 域实体的控制动作，可以放在同一个自动化中按季节或时段组合调度。例如：在冬季调用nexia.set_humidify_setpoint将加湿目标设为 35%，在夏季调用nexia.set_dehumidify_setpoint将除湿目标设为 50%，并配合nexia.set_aircleaner_mode切换到allergy模式应对过敏季节。

集成背景与底层要点

从 Nexia/American Standard/Trane 集成文档 可以看到该动作所依托的集成环境：

• 集成类型：hub 类型，通过云轮询（Cloud Polling）与制造商网络服务通信，ha_release为 0.108，支持通过 DHCP 自动发现。
• 气候平台：该集成通过climate平台暴露恒温器控制能力，本文所述动作正是围绕 climate 实体（如climate.downstairs）提供的扩展控制。
• 支持的型号：Trane 的XL1050、XL850、XL824官方支持；American Standard 的AZONE1050、AZONE850、ACONT824已有报告可用；XL624、XL950、AZONE950、AZEMT500、AZEMT400B等型号不受支持，其他型号未经过测试。
• 相关传感器：集成会为每台恒温器提供 Relative Humidity（相对湿度）传感器，可作为自动化中判断"何时调整除湿设定点"的输入；同时还提供 Air Cleaner Mode、System Status 等传感器，帮助你确认动作是否按预期生效。

此外，从版本发布说明（见 2022.6 发布说明）可知，该集成后续移除了非标准的humidify_supported和dehumidify_supported属性，因为设备是否支持这些功能可以通过dehumidify_setpoint等属性是否存在来推断。这一实现细节意味着：如果你的恒温器不支持除湿功能，相关实体上不会暴露dehumidify_setpoint属性，调用本动作自然也不会生效，因此在自动化中建议先通过属性存在性判断设备能力。

常见注意点

• 全分区生效：设置影响同一台恒温器的所有分区，即使目标只指向其中一个分区实体。
• 取值范围：humidity必须为 35–65 之间的整数百分比，超出范围的值可能被设备拒绝或忽略。
• 必填字段：target与humidity均为必填项。
• 设备能力限制：仅支持除湿功能的恒温器型号才可使用本动作；不支持时请先检查实体是否具备dehumidify_setpoint相关属性。

以上要点均可在 动作参考文档 及其配套的 UI/YAML 文档片段（UI 使用说明、YAML 使用说明、目标说明）中找到依据。配置完成后，建议在自动化中先以单个分区实体为目标测试取值，再逐步推广到区域或设备级目标，确保除湿策略符合整屋的舒适度预期。

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