更新


更新实体是一个指示是否可用于设备或服务的实体。这可以是任何更新,包括更新诸如灯泡或路由器之类的设备,或用于附加组件或容器之类的软件更新。

更新实体的状态指示是否有更新待处理,如果有可用的更新,则可以通过集成到实体提供有关该更新的更多信息。例如,可用的版本,发行说明的摘要,甚至提供有关可用更新的更多信息的链接。

最后,有两种可用于更新实体的服务。如果可能的话,并由集成提供更新实体,从而触发家庭助理的实际更新。必威是什么暴露的其他服务允许跳过提供的更新。

更新实体将在这里消耗并由其他集成提供,并且不是为直接创建的。

因此,此页面不提供有关如何创建更新实体的说明。请看“更新”类别在集成页面上查找提供更新实体的集成。

更新实体的状态

更新实体的状态反映了是否可用。当状态是,这意味着有一个更新;当一切都是最新的,状态是离开

此外,暴露于以下状态属性以提供有关更新状态的更多信息:

  • 标题:可用软件或固件的标题/名称。由于可以在家庭助理中更改设备名称或实体名称,因此此标题将提供软件或固件的实际名称。必威是什么
  • installed_version:当前正在安装和使用的当前版本。
  • 最新版本:可用于安装的最新版本。
  • 跳过:如果跳过版本更新,将设置此属性并包含跳过的实际版本。
  • Release_summary:可用更新的发行说明摘要。
  • Release_url:有关可用更新的完整发布公告的链接。

设备类

这些更新实体在前端显示的方式取决于其设备类。为开关支持以下设备类:

  • 没有任何:通用软件更新。这是默认值,不需要设置。
  • 固件:此更新集成提供了牢固的货物。

服务

该更新实体公开了两项可用于安装或跳过提供的软件更新的服务。

服务update.install

update.install服务可用于为设备或服务安装提供的更新。

如果集成提供此功能,则仅适用于更新实体。此外,如果通过集成允许,该服务提供了安装特定版本的服务,甚至可以在安装更新之前进行备份。

服务数据属性 选修的 描述
ENTITY_ID 字符串或字符串列表ENTITY_IDS的更新。要定位所有更新,请设置ENTITY_ID全部
版本 是的 要安装的特定更新版本(如果未提供),将安装最新的可用更新。此术的可用性取决于集成。
备份 是的 如果设置为真的,在安装更新之前将进行备份。此属性的可用性取决于集成。

示例服务电话:

服务update.install目标ENTITY_ID-update.my_light_bulb

服务update.skip

update.skip服务可用于跳过对设备或服务的更新。

跳过提供的更新后,实体将返回到离开状态,这意味着没有可用的更新。

服务update.skip目标ENTITY_ID-update.my_light_bulb

即使跳过更新并显示为离开(意思是没有更新),如果有一个较新的版本,请调用update.install实体上的服务仍将安装最新版本。

服务update.clear_skipped

update.clear_skipped服务可用于删除先前跳过的跳过版本标记,以对设备或服务进行更新。

跳过提供的更新后,实体将返回到离开状态,但直到较新版本再次可用之前,它不会返回它。

使用update.clear_skipped服务,可以删除跳过的版本标记,因此实体将返回到状态和更新通知将返回。

服务update.clear_skipped目标ENTITY_ID-update.my_light_bulb

例如,在自动化中,这可能会有所帮助,即您以前标记为“跳过”的所有更新。提醒更新。

示例:发送更新可用通知

使用更新实体的常见用例是通知您是否可以安装更新。使用更新实体,这很简单。

这是一个自动化的YAML示例,该示例在可用的灯泡更新时会发出通知。

自动化-别名发送通知什么时候更新可用的”扳机平台状态ENTITY_IDupdate.my_light_bulb在”行动别名发送通知我的电话关于更新”服务notify.iphone数据标题新的更新可用的”信息新的更新可用的为了my_light_bulb!”