Skip to main content

Hass 对象

在开发 Home Assistant 时,你会看到一个无处不在的变量:hass。这是 Home Assistant 实例,它将让你访问系统的各个部分。

hass 对象

Home Assistant 实例包含四个对象,帮助你与系统进行交互。

对象描述
hass这是 Home Assistant 的实例。允许启动、停止和排队新的任务。
hass.config这是 Home Assistant 的核心配置,暴露位置、温度偏好和配置目录路径。
hass.states这是状态机。它允许你设置状态并跟踪状态何时被更改。查看可用的方法。
hass.bus这是事件总线。它允许你触发和侦听事件。查看可用的方法。
hass.services这是服务注册表。它允许你注册服务操作。查看可用的方法。
Home Assistant 核心架构概述

在哪里找到 hass

根据你正在编写的内容,hass 对象的可用方式不同。

组件 传入 setup(hass, config)async_setup(hass, config)

平台 传入 setup_platform(hass, config, add_entities, discovery_info=None)async_setup_platform(hass, config, async_add_entities, discovery_info=None)

实体 一旦通过平台内的 add_entities 回调添加,作为 self.hass 可用。