Yaml


必威是什么家庭助理使用Yaml用于配置的语法。YAML可能需要一段时间才能习惯,但在允许您表达复杂配置方面确实很强大。

虽然越来越多的集成通过UI配置,但对于某些人来说,您将在您的configuration.yaml文件以指定其设置。

以下示例条目假设您想设置通知集成Pushbullet平台

通知平台Pushbulletapi_keyO.1234ABCD“姓名Pushbullet
  • 一个一体化提供了一些功能的核心逻辑(例如通知提供发送通知)。
  • 一种平台使连接到特定的软件或硬件平台(例如Pushbullet与PushBullet.com的服务一起使用)。

YAML语法的基础是块收集和包含键值对的映射。集合中的每个项目都以一个-而映射的格式核心价值。这有点类似于哈希表或更具体地说是python中的词典。这些也可以嵌套。当心,如果指定重复键,则使用键的最后值

请注意,凹痕是使用YAML指定关系的重要组成部分。缩进的事物是嵌套的“内部”事物,这些东西更高。因此,在上面的示例中平台:Pushbullet是(嵌套在内部)的属性通知一体化。

如果您不使用具有固定宽度字体的编辑器,则获得正确的凹痕可能会很棘手。标签不允许用于凹痕。惯例是在每个凹痕层次上使用2个空间。

您可以使用在线服务YAML验证器要在将其加载到家庭助手之前,请检查您的YAML语法是否正确,这将节省您一些时间。必威是什么如果您这样做,请注意,这是第三方服务,不受家庭助理社区的维护。必威是什么

请注意直接在您的configuration.yaml文件。私人数据可以存储在任何一个单独的文件或IN环境变量,这避免了此安全问题。

文字字符串之后是评论,被系统忽略。

下一个示例显示了input_select集成使用块收集作为选项值的集成。其他属性(例如姓名:)使用映射指定。请注意,第二行只有威胁:在同一行上没有值。这里的威胁是Input_Select的名称,其值是嵌套在其下方的所有内容。

input_select威胁姓名威胁等级”#用于选项的集合选项-0-1-2-3最初的0

下面的示例显示了在映射中嵌套映射的集合。在家庭必威是什么助理中,这将创建两个传感器,每个传感器都使用MQTT平台,但具有不同的值state_topic(用于MQTT传感器的属性之一)。

传感器-平台mqttstate_topic传感器/主题”-平台mqttstate_topicSensor2/主题”

包括值

环境变量

在家庭必威是什么助理核心安装中,您可以通过!env_var。请注意,在可以指定这些方案的情况下,这仅适用于家庭助理核心安装。必威是什么建议使用常规家庭必威是什么助理用户!包括语句。

例子密码!env_var密码

默认值

如果未设置环境变量,则可以退回到默认值。

例子密码!env_var密码default_password

包括整个文件

为了提高可读性,您可以从主配置文件中取出某些域!包括-句法。

!包括lights.yaml

有关此功能的更多信息也可以在分裂配置

常见问题

找到角色“ \ t”

如果您看到以下消息:

找到无法启动任何令牌的字符“ \ t”

这意味着您错误地输入了一个标签字符,而不是空格。

上和下箱

必威是什么家庭助理对案例敏感,一种状态'在''在'或者'在'。同样的一个实体group.doorsgroup.doors

如果您遇到麻烦,请检查家庭助理在Dev-State菜单中报告的情况,必威是什么开发者工具

布尔人

YAML待遇y,,,,真的,,,,是的,,,,一切真的n,,,,错误的,,,,,,,,离开作为错误的。这意味着,如果您想将实体的状态设置为必须引用它'在'否则,它将被翻译为设置状态为真。同样适用于离开

不引用该值可能会产生错误,例如:

不是字典值 @ data的有效值