前端

Home Assistant 前端界面由面板及侧边栏组成,侧边栏中为各面板的跳转链接。每一个页面可视为一个独立的面板,默认有概览、日志、历史、配置、地图及开发者工具下的服务、状态、事件、模板、LOG 等面板。

1. 概览

Home Assistant 的主要交互界面,由名称、标签页、徽章、卡片、语音交互图标组成。


1.1 标签页

群组的展现方式之一,在群组设置中设定 view: yes 后生成。


1.2 徽章

传感器及定位设备接入后的默认展现方式,由图标和文字状态构成,设备加入群组后生成卡片。


1.3 卡片

群组、开关、灯、媒体播放器等可交互设备的默认展现方式。


1.4 语音交互

Home Assistant 自带的基于浏览器本地的语音交互功能,在配置文件中添加 conversation: 后添加,默认开启。支持多语种识别。

iOS 设备无法使用此功能


2. 地图

接入系统组件 map 后开启,以 OpenStreet Map 为图层的地图。

根据《中华人民共和国测绘法》规定,国内部分地图要素保密,因此 Home Assistant 默认地图显示的有关中国的地图要素较少。欢迎换用中国开发者自制的地图面板


3. 日志

接入系统组件 logbook 后开启,记录系统日志。

具体配置方法,详见 系统组件 页。


4. 历史

接入系统组件 history 后开启,展现设备历史数据的可视化视图。


5. 配置

接入系统组件 config 后开启,用以 Home Assistant 系统的基础配置及操作。


5.1 General - 主面板

进行系统设置的主要面板,其中『重载配置』区依次为『重载自定义』、『重载群组』、『重载自动化』、『重载脚本』。

当配置文件分离后,才会生成上述『重载按钮』,具体见『配置文件分离』文档。


6. 购物清单

接入系统组件 shopping_list 后开启,生成一个类似『待办事项』功能的页面,可与『语音交互』联动。

输入任意文字回车后『添加事项』,点击前端选框表示『完成事项』,点击右上角图标可『清除已完成项目』。


7. 开发者工具

从左至右,依次为:

7.1 服务

进行服务调用,部分服务将会显示变量说明。


7.2 状态

查询及设定设备的 Entity_ID、状态、详情等,可以在各栏进行搜索与筛选。

在此处设定的设备状态仅在 Home Assistant 生效,并非对真实设备发生操作。


7.3 事件

调用系统事件,用于开发调试。


7.4 模板

展示及调试系统『模板』,详见『自定义模板』文档。


7.5 信息

展示当前 Home Assistant 版本、配置文件夹路径以及 LOG 区域。

其中 LOG 区域数据源于 home-assistant.log 文件。