事件
家庭助理的核心是活动巴士必威是什么。活动总线允许任何集成都可以开火或聆听活动。这是一切的核心。例如,任何国家更改都将在活动巴士上宣布为state_changed
事件包含一个实体的先前和新状态。
必威是什么家庭助理包含一些内置事件,用于在各种集成之间进行协调。
普通字段
所有事件都共享这些基本字段。
场地 | 描述 |
---|---|
事件类型 |
事件的类型。例子:call_service 。 |
起源 |
活动的起源。偏僻的 (来自API,例如Webhook)或当地的 (其他一切)。 |
time_fired |
事件被解雇时。例子:2022-01-28T12:19:53.736380+00:00 。 |
语境 |
带有词典语境。例子:{'id':'123',“ parent_id”:null,'user_id':'abc'} 。 |
此外,所有事件都包含一个数据
带有特定于事件信息的字典。这些如下所述。
内置事件(核心)
call_service
当调用服务时,该事件被解雇。
场地 | 描述 |
---|---|
领域 |
服务领域。例子:光 。 |
服务 |
致电的服务。例子:打开 |
service_data |
带有服务调用参数的字典。例子:{'亮度':120} 。 |
service_call_id |
带有唯一呼叫ID的字符串。例子:23123-4 。 |
component_loaded
当已加载和初始化新的集成时,就会触发此事件。
请注意,在家庭助理启动期间为每次加载的集成启动此事件时,家庭助理的自动化引擎最后启动了。必威是什么因此,此事件不能在启动过程中运行自动化,因为它会错过这些事件。
场地 | 描述 |
---|---|
零件 |
刚刚初始化的集成域。例子:光 。 |
core_config_updated
当更新核心配置时,例如在更改位置时,将触发此事件。
它不包含其他数据。
data_entry_flow_progresse
当数据输入流动发生变化并被前端使用以重新加载流状态时,该事件将发射。
场地 | 描述 |
---|---|
处理程序 |
流动处理程序。 |
flow_id |
流量的识别。 |
homeassistant_start,homeassistant_started
这些事件是在家庭助理启动期间按以下顺序解雇的:必威是什么
homeassistant_start
homeassistant_started
这些事件不包含其他数据。
如果您想在家庭助理开始活动中触发自动化,我们建议使用特殊必威是什么必威是什么家庭助理扳机而不是听这些事件。
homeassistant_stop,homeassistant_final_write,homeassistant_close
这些事件按以下顺序在家庭助理关闭期间开除:必威是什么
homeassistant_stop
homeassistant_final_write
homeassistant_close
这些事件不包含其他数据。
请注意homeassistant_final_write
和homeassistant_close
,不能与自动化一起使用,因为在解雇这些引擎时已经停止了自动化引擎。
如果您想在家庭助理停止活动中触发自动化,我们建议使用特殊必威是什么必威是什么家庭助理扳机而不是听这些事件。
logbook_entry
场地 | 描述 |
---|---|
姓名 |
实体的名称。例子:利钦光 。 |
信息 |
信息。例子:被打开了 |
领域 |
可选的,条目的域。例子:光 |
ENTITY_ID |
可选的,标识符已记录的实体。 |
service_registered
当家庭助理内注册新服务时,该活动将被解雇。必威是什么
场地 | 描述 |
---|---|
领域 |
提供此服务的组件的域。例子:光 。 |
服务 |
服务的名称。例子:打开 |
service_remaved
当服务已从家庭助理删除时,该活动将被解雇。必威是什么
场地 | 描述 |
---|---|
领域 |
提供此服务的组件的域。例子:光 。 |
服务 |
服务的名称。例子:打开 |
state_changed
当一个州发生变化时,该事件被解雇。它包含实体标识符和new_state
和old_state
实体状态对象。
场地 | 描述 |
---|---|
ENTITY_ID |
已更改的实体的标识符。例子:Light.Kitchen |
old_state |
实体更改之前的先前状态。如果第一次设置状态,则被省略。 |
new_state |
实体的新状态。如果国家被删除,则省略。 |
themes_upded
在设置或重新加载主题之后,该事件将发射。它不包含其他数据。
user_added
添加用户后,该事件将发射。
场地 | 描述 |
---|---|
用户身份 |
识别新用户。 |
user_remaved
当用户被删除后,该事件将发射。
场地 | 描述 |
---|---|
用户身份 |
识别已删除的用户。 |
内置事件(默认集成)
automation_reloded
一体化:自动化
当自动化重新加载并因此可能发生变化时,该事件被解雇。
此事件不包含其他数据。
automation_trigned
一体化:自动化
当自动化触发时,该事件将发射。
场地 | 描述 |
---|---|
姓名 |
自动化的名称。 |
ENTITY_ID |
自动化的标识符。 |
scene_reloded
一体化:乡亲
当场景重新加载并因此可能发生了变化时,该事件被解雇。
此事件不包含其他数据。
script_started
一体化:脚本
运行脚本时会发射此事件。脚本可以由用户调用或由自动化触发。可以跟踪所得更改,因为所有相关事件都将共享与此事件相同的上下文。
场地 | 描述 |
---|---|
姓名 |
运行脚本的名称。 |
ENTITY_ID |
运行脚本的标识符。 |