2025.3.4
首页 ▸ Integrations ▸

Humidifier

The Humidifier integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] is built for the controlling and monitoring of humidifiers, dehumidifiers, and hygrostat devices.

Note

构建模块集成

这个 humidifier 是一个构建模块集成，无法直接添加到你的 Home Assistant 中，但可以被其他集成使用和提供。

构建模块集成不同于典型的与设备或服务连接的集成。相反，其他将设备或服务集成到 Home Assistant 中的集成使用这个 humidifier 构建模块来提供实体、服务和其他你可以在自动化或仪表板中使用的功能。

如果你的某个集成具有这个构建模块，这个页面记录了 humidifier 构建模块所提供的功能。

The state of a humidifier entity

The state of a humidifier entity can be either On or Off.

In addition, the entity can have the following states:

  • Unavailable: The entity is currently unavailable.
  • Unknown: The state is not yet known.

Device class

设备类别是 Home Assistant 中的一种测量分类。它影响实体在 仪表板 中的表示方式。这可以在 自定义部分 中进行修改。例如，不同的状态可能会用不同的图标、颜色或文本来表示。

The screenshot shows different text and UI for different device classes for humidifiers:

Humidifier device classes.

The following device classes are supported for humidifiers:

  • Humidifier: Adds humidity to the air around it.
  • Dehumidifier: Removes humidity from the air around it.

Actions

Humidifier actions

Available actions: humidifier.set_mode, humidifier.set_humidity, humidifier.turn_on, humidifier.turn_off, humidifier.toggle

Tip

Not all humidifier actions may be available for your platform. Be sure to check the available actions Home Assistant has enabled by checking the Actions page in the Developer Tools.

Action humidifier.set_mode

Set mode for the humidifier device. This action is only available if the device supports operating in several working modes. The list of available modes and the device functionality in every mode depend on the device itself.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.
mode no New mode.

Automation example 

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: humidifier.set_mode
      target:
        entity_id: humidifier.bedroom
      data:
        mode: "eco"

Action humidifier.set_humidity

Set target humidity of the humidifier device

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.
humidity no New target humidity for humidifier device

Automation example 

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: humidifier.set_humidity
      target:
        entity_id: humidifier.bedroom
      data:
        humidity: 60

Action humidifier.turn_on

Turn the humidifier device on.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.

Action humidifier.turn_off

Turn the humidifier device off.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.

Action humidifier.toggle

Toggle the humidifier device on/off.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.

相关主题