MQTT场景


mqtt场景平台使您可以控制启用MQTT的场景。

配置

要在安装中启用MQTT场景,请将以下内容添加到您的configuration.yaml文件:

#示例Configuration.yaml条目场景-平台mqttcommand_topicZigBee2MQTT/Living_room_group/set

配置变量

可用性 列表 ((选修的

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

payload_available 细绳 ((选修的,默认:在线

代表可用状态的有效载荷。

payload_not_available 细绳 ((选修的,默认:离线

代表不可用状态的有效载荷。

话题 细绳 必需的

MQTT主题订阅以接收可用性(在线/离线)更新。

value_template 模板 ((选修的

定义a模板从中提取设备的可用性话题。为了确定设备的可用性结果,将与payload_availablepayload_not_available

availability_mode 细绳 ((选修的,默认:最新

什么时候可用性已配置,这控制了将实体设置为可用的。有效的条目是全部,,,,任何, 和最新的。如果设置为全部,,,,payload_available在实体被标记为在线之前,必须在所有配置的可用性主题上收到。如果设置为任何,,,,payload_available在实体被标记为在线之前,必须在至少一个配置的可用性主题上收到。如果设置为最新的, 最后payload_available或者payload_not_available在任何配置的可用性主题上都收到了可用性。

availability_template 模板 ((选修的

定义a模板从中提取设备的可用性availability_topic。为了确定设备的可用性结果,将与payload_availablepayload_not_available

availability_topic 细绳 ((选修的

MQTT主题订阅以接收可用性(在线/离线)更新。不得一起使用可用性

command_topic 细绳 ((选修的

要发布的MQTT主题payload_on激活场景。

enabled_by_default 布尔 ((选修的,默认:正确

标志,该标志首先添加时定义是否应启用实体。

Entity_Category 细绳 ((选修的,默认:无

类别实体。

图标 图标 ((选修的

场景的图标。

姓名 细绳 ((选修的,默认:MQTT场景

显示此场景时要使用的名称。

object_id 细绳 ((选修的

代替姓名用于自动生成ENTITY_ID

payload_available 细绳 ((选修的,默认:在线

代表可用状态的有效载荷。

payload_not_available 细绳 ((选修的,默认:离线

代表不可用状态的有效载荷。

payload_on 细绳 ((选修的,默认:ON

将发送给的有效载荷command_topic激活MQTT场景时。

QoS 整数 ((选修的,默认:0

国家主题的最大QoS级别。默认值为0,也将用于发布消息。

保持 布尔 ((选修的,默认:false

是否已发表的消息应在是否有保留标志。

唯一身份 细绳 ((选修的

独特地标识此场景实体的ID。如果两个场景具有相同的独特身份证,则家庭助理将引起例外。必威是什么

确保您的主题完全匹配。一些主题/一些主题是不同的主题。

例子

在本节中,您将找到一些如何使用MQTT场景的现实示例。

完整配置

下面的示例显示了场景的完整配置。

#示例Configuration.yaml条目场景-平台mqtt唯一身份living_room_party_scene姓名活的房间聚会场景”command_topichome/living_room/party_scene/set'可用性-话题主页/living_room/party_scene/可用”payload_on在”QoS0保持真的

与JSON有效载荷一起使用

下面的示例显示了使用JSON有效载荷的配置。

#示例Configuration.yaml条目场景-平台mqtt姓名客厅蓝色场景唯一身份living_room_blue_scenecommand_topic家庭/living_room/set”payload_on'{“ activate_scene”:“蓝色的场景”}'