MQTT 阀门

订阅以接收可用性（在线/离线）更新的 MQTT 主题列表。不得与 availability_topic 一起使用。

当配置了 availability 时，这控制设置实体为 available 所需的条件。有效条目有 all、any 和 latest。如果设置为 all，则必须在所有配置的可用主题上接收到 payload_available，实体才会标记为在线。如果设置为 any，则在至少一个配置的可用主题上接收到 payload_available 时，实体才会标记为在线。如果设置为 latest，则最后在任何配置的可用主题上接收到的 payload_available 或 payload_not_available 控制可用性。

Defines a template to extract the device’s availability from the availability_topic. To determine the devices’s availability, the result of this template will be compared to payload_available and payload_not_available.

订阅以接收来自 MQTT 阀门设备的出生和 LWT 消息的 MQTT 主题。如果未定义 availability 主题，则阀门可用性状态将始终为 available。如果定义了 availability 主题，则阀门可用性状态默认为 unavailable。不得与 availability 一起使用。

Defines a template to generate the payload to send to command_topic.

发布命令以控制阀门的 MQTT 主题。发送的值可以是由 payload_open、payload_close 或 payload_stop 定义的值。如果 reports_position 设置为 true，则将发布数字值。

关于此阀门是其组成部分的设备的信息，以将其绑定到 设备注册表。仅在设置了 unique_id 时有效。必须存在至少一个标识符或连接以识别设备。

设置 设备的类别，更改在前端显示的设备状态和图标。device_class 可以为 null。

定义实体在首次添加时是否应启用的标记。

接收和发布的消息的有效负载编码。设置为 "" 以禁用传入有效负载的解码。

实体的 类别。

实体的图片 URL。

图标 用于实体。

Defines a template to extract the JSON dictionary from messages received on the json_attributes_topic. A usage example can be found in the MQTT sensor documentation.

订阅以接收 JSON 字典有效负载的 MQTT 主题，然后将其设置为传感器属性。用法示例可以在 MQTT 传感器 文档中找到。

阀门的名称。如果仅设备名称是相关的，可以设置为 null。

用于替代 name 以自动生成 entity_id。

定义开关是否在乐观模式下工作的标志。

表示在线状态的有效负载。

关闭阀门的命令有效负载。仅在 reports_position 设置为 false（默认）时使用。如果 reports_position 设置为 true，则不允许使用 payload_close。可以设置为 null 以禁用阀门的关闭选项。

表示离线状态的有效负载。

打开阀门的命令有效负载。仅在 reports_position 设置为 false（默认）时使用。如果 reports_position 设置为 true，则不允许使用 payload_open。可以设置为 null 以禁用阀门的打开选项。

停止阀门的命令有效负载。未配置时，阀门将不支持 valve.stop 动作。

必须为 valve。仅在 MQTT 自动发现设备消息 中允许并且是必需的。

表示关闭位置的数字。当执行操作时，阀门的位置将缩放到（position_closed…position_open）范围内，并在接收到值时缩放回来。

表示打开位置的数字。当执行操作时，阀门的位置将缩放到(position_closed…position_open)范围内，并在接收到值时缩放回来。

接收和发布消息时使用的最大 QoS 级别。

如果值报告位置或支持设定位置则设置为 true。启用 reports_position 选项将导致位置被发布，而不是由 payload_open、payload_close 或 payload_stop 定义的有效负载。在接收消息时，state_topic 将接受数字有效负载或以下状态消息之一：open、opening、closed 或 closing。

定义发布的消息是否应设置保持标志。

表示关闭状态的有效负载。仅在 reports_position 设置为 False（默认）时允许。

表示关闭状态的有效负载。

表示打开状态的有效负载。仅在 reports_position 设置为 False（默认）时允许。

表示正在打开状态的有效负载。

订阅以接收阀门状态消息的 MQTT 主题。状态主题接受状态有效负载（open、opening、closed 或 closing），或者如果支持 reports_position，则接受表示位置的数字值。在包含变量 state 和 position 的 JSON 格式中，这两个值可以一起接收。状态值为 “None” 将重置为 unknown 状态。空字符串将被忽略。

唯一标识该阀门的 ID。如果两个阀门具有相同的唯一 ID，Home Assistant 将引发异常。在使用基于设备的发现时是必需的。

Defines a template that can be used to extract the payload for the state_topic topic. The rendered value should be a defined state payload or, if reporting a position is supported and reports_position is set to true, a numeric value is expected representing the position. See also state_topic.