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 device’s availability from the availability_topic. To determine the devices’s availability result of this template will be compared to payload_available and payload_not_available.

订阅的 MQTT 主题，以接收来自 MQTT 设备的出生和 LWT 消息。如果未定义 availability，则二进制传感器将始终被视为 available，其状态将为 on、off 或 unknown。如果定义了 availability，则二进制传感器默认将被视为 unavailable，传感器的初始状态将为 unavailable。必须与 availability 一起使用。

有关此二进制传感器所处设备的信息，以将其与 设备注册表 绑定。仅在设置了 unique_id 时有效。必须存在标识符或连接中的至少一个以标识设备。

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

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

接收到的负载的编码。设置为 "" 以禁用对传入负载的解码。

实体的 类别。设置时，实体类别必须为传感器的 diagnostic。

实体的图片 URL。

如果设置，定义传感器状态过期后的秒数，如果未更新。过期后，传感器的状态变为 unavailable。默认情况下，传感器状态永不过期。

发送更新事件（导致 状态对象’s last_changed 更新），即使传感器的状态未更改。如果想在历史记录中拥有有意义的值图表，或者希望创建在每个传入状态消息上触发的自动化（不仅是在传感器的新状态与当前状态不同的情况）时，这很有用。

图标用于实体。

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

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

二进制传感器的名称。如果仅设备名称相关，可以设置为 null。

用于自动生成 entity_id 时替代 name

对于仅发送 on 状态更新的传感器（如 PIR），此变量设置一个延迟（以秒为单位），在此之后，传感器的状态将更新回 off。

表示 online 状态的字符串。

表示 offline 状态的字符串。

表示 off 状态的字符串。它将与 state_topic 中的消息进行比较（有关详细信息，请参见 value_template）

表示 on 状态的字符串。它将与 state_topic 中的消息进行比较（有关详细信息，请参见 value_template）

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

接收和发布消息时使用的最大 QoS 水平。

订阅的 MQTT 主题，以接收传感器的状态。有效状态为 OFF 和 ON。可以通过 payload_off 和 payload_on 配置选项设置自定义 OFF 和 ON 值。

唯一标识此传感器的 ID。如果两个传感器具有相同的唯一 ID，Home Assistant 将引发异常。在设备基础的发现中必需。

Defines a template that returns a string to be compared to payload_on/payload_off or an empty string, in which case the MQTT message will be removed. Remove this option when payload_on and payload_off are sufficient to match your payloads (i.e no preprocessing of original message is required).