更新
更新实体是一个指示是否可用于设备或服务的实体。这可以是任何更新,包括更新诸如灯泡或路由器之类的设备,或用于附加组件或容器之类的软件更新。
更新实体的状态指示是否有更新待处理,如果有可用的更新,则可以通过集成到实体提供有关该更新的更多信息。例如,可用的版本,发行说明的摘要,甚至提供有关可用更新的更多信息的链接。
最后,有两种可用于更新实体的服务。如果可能的话,并由集成提供更新实体,从而触发家庭助理的实际更新。必威是什么暴露的其他服务允许跳过提供的更新。
更新实体将在这里消耗并由其他集成提供,并且不是为直接创建的。
因此,此页面不提供有关如何创建更新实体的说明。请看“更新”类别在集成页面上查找提供更新实体的集成。
更新实体的状态
更新实体的状态反映了是否可用。当状态是在
,这意味着有一个更新;当一切都是最新的,状态是离开
。
此外,暴露于以下状态属性以提供有关更新状态的更多信息:
标题
:可用软件或固件的标题/名称。由于可以在家庭助理中更改设备名称或实体名称,因此此标题将提供软件或固件的实际名称。必威是什么installed_version
:当前正在安装和使用的当前版本。最新版本
:可用于安装的最新版本。跳过
:如果跳过版本更新,将设置此属性并包含跳过的实际版本。Release_summary
:可用更新的发行说明摘要。Release_url
:有关可用更新的完整发布公告的链接。
设备类
这些更新实体在前端显示的方式取决于其设备类。为开关支持以下设备类:
没有任何
:通用软件更新。这是默认值,不需要设置。固件
:此更新集成提供了牢固的货物。
服务
该更新实体公开了两项可用于安装或跳过提供的软件更新的服务。
服务update.install
这update.install
服务可用于为设备或服务安装提供的更新。
如果集成提供此功能,则仅适用于更新实体。此外,如果通过集成允许,该服务提供了安装特定版本的服务,甚至可以在安装更新之前进行备份。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
不 | 字符串或字符串列表ENTITY_ID S的更新。要定位所有更新,请设置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_ID:update.my_light_bulb到:“在”行动:别名:“发送通知到我的电话关于这更新”服务:notify.iphone数据:标题:“新的更新可用的”信息:“新的更新可用的为了my_light_bulb!”