mqtt statestream

这mqtt_stateTreamIntegration发布了单个MQTT主题的家庭助理的状态变化。必威是什么MQTT集成是MQTT Statestream工作的先决条件。

配置

要在家庭助理中启用MQTT Statestream，请在您的必威是什么configuration.yaml文件：

＃示例Configuration.yaml条目mqtt_stateTream：base_topic：乡亲publish_attributes：真的Publish_timestamps：真的

配置过滤器

默认情况下，不会排除任何实体。限制哪些实体被暴露于mqtt statestream，您可以使用包括和排除参数。

＃示例过滤器要包括指定域并排除指定的实体mqtt_stateTream：base_topic：乡亲包括：域：-alarm_control_panel-光entity_globs：-binary_sensor。*_占用排除：实体：-light.kitchen_light

过滤器的应用如下：

1. 否包括或排除 - 通过所有实体
2. 包括，不排除 - 仅包括指定实体
3. 排除，否包括 - 仅排除指定实体
4. 两者都包括和排除：
   • 包括指定的域和/或球形图案
     • 如果包括域，并且不排除或匹配实体，则通过
     • 如果实体匹配包括球形模式，并且实体与任何排除条件（域，全球模式或列出）不匹配，则通过
     • 如果不包括域，则全球模式不匹配，并且不包括实体，则失败
   • 排除指定的域和/或全球模式，包括不列出域或球模式
     • 如果排除域并且不包括实体，则失败
     • 如果实体匹配不包括球模式和未包括的实体，则失败
     • 如果实体与任何排除条件不匹配（域，全球模式或列出），请通过
   • 不包括或排除指定域或球模式
     • 如果包括实体，请通过（如上＃2）
     • 如果实体包括和排除实体，则将忽略实体排除

常见的过滤示例

＃排除实体的示例mqtt_stateTream：base_topic：乡亲排除：域：-转变实体：-传感器

在上面的示例中，除了switch.x和传感器将出版给MQTT。

＃排除实体的示例mqtt_stateTream：base_topic：乡亲包括：域：-传感器实体：-锁。重要

在此示例中，只有传感器和锁。重要将出版。

＃排除实体的示例mqtt_stateTream：base_topic：乡亲包括：域：-传感器排除：实体：-传感器

在此示例中，除了传感器将出版。

手术

当任何家庭助理实体必威是什么更改时，此集成将发布到MQTT。

每个实体的主题都是不同的，因此您可以轻松地将其他系统订阅到您感兴趣的实体。该主题将以形式base_topic/域/实体/状态。

例如，在上面的示例配置中，如果已打开一个称为“ light.master_bedroom_dimmer”的实体，则此集成将发布在到乡亲/灯/灯/master_bedroom_dimmer/state。

如果该实体也具有称为的属性亮度，集成还将将该属性的值发布到乡亲/光/master_bedroom_dimmer/亮度。

在发布之前，所有状态和属性都通过JSON序列化传递。请注意这导致引用字符串（例如，“ ON”字符串将以“ on”为“ on”）。您可以通过使用value_json代替价值。

实体的最后一个_updated和last_changed值将发布到homeassistant/light/master_bedroom_dimmer/last_updated和homeassistant/light/master_bedroom_dimmer/last_changed， 分别。时间戳为ISO 8601格式 - 例如，2017-10-01T23：20：30.920969+00：00。