MQTT 二进制传感器

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

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

定义一个 模板 以从 availability_topic 中提取设备的可用性。要确定设备的可用性，此模板的结果将与 payload_available 和 payload_not_available 进行比较。

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

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

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

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

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

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

实体的图片 URL。

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

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

实体的 图标。

定义一个 模板 以从 json_attributes_topic 上接收到的消息中提取 JSON 字典。使用示例可以在 MQTT 传感器 文档中找到。

订阅以接收 JSON 字典有效负载并将其设置为传感器属性的 MQTT 主题。使用示例可以在 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 将引发异常。与基于设备的发现一起使用时必需。

定义一个 模板，返回一个字符串以与 payload_on/payload_off 进行比较，或返回一个空字符串，在这种情况下，MQTT 消息将被删除。当 payload_on 和 payload_off 足以匹配您的有效负载时（即不需要对原始消息进行预处理），请删除此选项。