词汇表

词汇表涵盖了与 Home Assistant 相关的术语。

A


Action

动作在 Home Assistant 的多个地方使用。作为脚本或自动化的一部分,动作定义了触发器被激活后将发生的事情。在脚本中,动作被称为序列。动作是一个与目标交互以使某些事情发生的软件功能。动作可以使用其他动作和/或场景与实体交互并使这些实体执行某些操作。动作还可以包括条件和延迟。一个动作可以同时执行多个动作。例如,如果检测到您在房间中的存在,一个动作可能会执行一个动作来打开灯,并在延迟后执行另一个动作来开始播放音乐。动作也用于仪表板,例如作为 UI 元素上的点击或按住动作。当触发时,动作会执行另一个动作。Home Assistant 提供了一系列预定义的动作,例如 homeassistant.turn_onhomeassistant.togglehomeassistant.reload

阅读更多关于 Action

Add-on

插件是可以安装在 Home Assistant OS 上的额外独立第三方软件包。这些插件提供的应用程序大多数可以通过集成与 Home Assistant 集成。插件的例子包括:MQTT 代理、数据库服务或文件服务器。

Area

在 Home Assistant 中,区域是设备和实体的逻辑分组,旨在匹配物理世界中的区域(或房间):您的家。例如,客厅区域将分组您客厅中的设备和实体。区域允许您将动作目标定位到整个设备组。例如,关闭客厅中的所有灯。家中的位置,例如客厅、舞池等。区域可以分配到楼层。区域还可以用于自动生成的卡片,例如区域卡片

Automation

自动化将一个或多个触发器连接到一个或多个动作,以“当触发器发生时执行动作”的方式,并附加可选的条件。例如,自动化可能将触发器“日落”连接到动作“打开灯”,但仅在满足条件“有人在家”的情况下。通过蓝图功能可以获得预制的常见用例自动化。

阅读更多关于 Automation

B


Backup

Home Assistant 具有内置功能,可以创建包含配置副本的文件。这可以用于恢复您的 Home Assistant 以及迁移到新系统。备份功能在某些安装类型中可用。

阅读更多关于 Backup

Binary sensor

二进制传感器返回只有两种状态的信息 - 例如开或关。

阅读更多关于 Binary sensor

Blueprint

蓝图是一个脚本、自动化或模板实体配置,其中某些部分标记为可配置。这允许用户基于相同的蓝图创建多个脚本、自动化或模板实体,每个都有自己的配置特定设置。蓝图由社区在论坛上的蓝图交换中共享。

阅读更多关于 Blueprint

Button

按钮实体可以触发事件或触发对设备或服务的动作。它可以与物理按钮进行比较。按钮实体没有像“开”或“关”这样的状态,但在 Home Assistant UI 或通过动作按下时会保留最后按下的时间戳。

阅读更多关于 Button

C


Category

类别是一种组织工具,允许在表中对项目进行分组。像标签一样,类别允许不考虑项目的物理位置进行分组。例如,在自动化页面上,您可以创建“通知”或“NFC 标签”类别,以查看分组或过滤的自动化。类别对于每个表都是唯一的。自动化页面可以与场景、脚本或助手设置页面具有不同的类别。

Climate

气候实体允许您控制和监控 HVAC(供暖、通风和空调)设备和恒温器。

阅读更多关于 Climate

Commissioning

在 Matter 设备的上下文中,调试是将设备添加到 Matter 控制器的过程。它相当于在 Zigbee 或 Z-Wave 中配对设备。调试是通过扫描二维码或手动输入代码来完成的。代码打印在设备或其包装上。代码包含有关设备的信息,例如其类型、制造商和序列号。控制器使用此信息来识别设备并下载控制设备所需的信息。例如,控制器下载设备的功能,例如支持的命令和可用的属性。控制器还下载设备的配置,例如设备的名称和位置。

阅读更多关于 Commissioning

Component

更广为人知的是:集成。集成以前被称为组件。

Condition

条件是自动化的可选部分,如果不满足条件,将阻止动作触发。

阅读更多关于 Condition

Configuration file

configuration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。

阅读更多关于 Configuration file

Cover

盖子是可以打开和关闭的设备,例如百叶窗、车库门等,并且可以选择设置为特定位置。

阅读更多关于 Cover

Custom integration

自定义集成是由 Home Assistant 社区中的某人创建并发布供其他人自行使用的集成。Home Assistant 项目不支持自定义集成。Home Assistant 开发团队不会审查或测试它们,因此可能会对您的 Home Assistant 实例的稳定性产生负面影响。自定义集成的一个例子是 Spook 集成。

Customize

自定义允许您覆盖配置中设备的默认参数。

D


Device

设备是表示包含实体的物理或逻辑单元的模型。作为物理单元的设备示例 一个名为“咖啡机”的智能插头,它提供 2 个实体:一个用于打开或关闭电源的开关实体(“咖啡机电源开关”)和一个用于电源监控的传感器实体(“咖啡机电源传感器”)。作为逻辑单元的设备示例 一个带有 4 个房间传感器的 ecobee 恒温器。此恒温器在 Home Assistant 中被视为 5 个设备:1 个带有 4 个传感器的恒温器设备,以及每个房间传感器的 1 个设备。每个设备可以位于不同的区域,并且在该区域内可能有多个输入或输出。设备具有诸如 ID、制造商、名称、型号、硬件版本、固件版本、连接等属性。

Device tracker

设备跟踪器用于跟踪设备的存在或位置。

阅读更多关于 Device tracker

Diagnostics

诊断集成提供了一种从设备或集成下载诊断数据以在问题报告中共享的方法。在报告问题时共享诊断数据可以让开发人员更快地诊断和修复您报告的问题。

阅读更多关于 Diagnostics

Discovery

发现是 zeroconf/mDNS 和 uPnP 设备在被发现后自动设置的过程。

Domain

Home Assistant 中的每个集成都有一个唯一标识符:域。Home Assistant 中可用的所有实体和动作都是由集成提供的,因此属于这样的域。实体或动作的第一部分,在 . 之前,显示它们所属的域。例如 light.kitchenlight 域中的一个实体,来自 light 集成,而 hue.activate_scenehue 域的 activate_scene 动作,属于 Hue 集成

E


Entity

实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。实体有状态。作为设备一部分的实体示例 一个组合温度和湿度传感器设备提供两个传感器实体。一个用于温度(例如 sensor.temperature,状态为 21.0,单位为 °C),一个用于湿度(例如 sensor.humidity,状态为 65.4,单位为 %)。作为服务一部分的实体示例 一个提供 3 个实体的天气服务:风速、气压和臭氧水平。用于控制的实体示例 当温度超过 30 °C 时打开的风扇。对于常见的集成,有标准化的实体类型,例如灯、开关、摄像头、传感器、风扇或真空吸尘器。一些实体不是设备或服务的一部分。独立实体的示例包括自动化、脚本、场景实体和助手实体(例如输入助手)。大多数实体属性与状态相关。实体具有可选属性,例如友好名称、测量单位以及可以在前端显示的图标或图片。

阅读更多关于 Entity

Event

每当 Home Assistant 中发生某些事情时,都会触发一个事件。有不同类型的事件,例如状态更改事件、动作触发事件或时间更改事件。所有实体都会产生状态更改事件。每当状态更改时,都会产生状态更改事件。事件可用于触发自动化或脚本。例如,您可以在灯打开时触发自动化,然后在该房间中打开扬声器。事件还可用于触发前端的动作。例如,您可以在按下按钮时触发动作。

阅读更多关于 Event

F


Floor

Home Assistant 中的楼层是区域的逻辑分组,旨在匹配您家中的物理楼层。设备和实体未分配到楼层,而是分配到区域。楼层具有属性,例如:楼层 ID、名称、别名(用于助手)、图标和楼层级别。这些属性中的某些是可选的。级别编号可以为负数,以反映地下室以下的楼层。楼层可用于自动化和脚本,作为动作的目标。例如,在您上床睡觉时关闭楼下楼层的所有灯。

Frontend

前端是 UI 的必要组件,也是您可以定义主题的地方。

阅读更多关于 Frontend

G


Group

组是一种将实体组织成单个单元的方法。

阅读更多关于 Group

H


HASS

HASS 或 hass 通常用作 Home Assistant 的缩写。它也是命令行工具。

HassOS

Home Assistant 操作系统的另一个名称

阅读更多关于 HassOS

Home Assistant Container

Home Assistant Container 是 Home Assistant Core 的独立容器化安装。任何 OCI 兼容的运行时都可以使用,但文档重点是 Docker。

阅读更多关于 Home Assistant Container

Home Assistant Core

Home Assistant Core 是 Home Assistant 核心的 Python 程序。它是所有四种安装类型的一部分,可以在各种操作系统上运行。它可以独立安装(没有 Home Assistant Supervisor),使用虚拟环境(通常称为 Home Assistant Core 安装方法)或作为容器使用 Docker(通常称为 Home Assistant Container 安装方法)。

阅读更多关于 Home Assistant Core

Home Assistant Operating System

Home Assistant OS,即 Home Assistant 操作系统,是一个嵌入式、简约的操作系统,旨在在单板计算机(如 Raspberry Pi)或虚拟机上运行 Home Assistant 生态系统。它包括 Home Assistant Core、Home Assistant Supervisor,并支持插件。Home Assistant Supervisor 使其保持最新,无需您管理操作系统。Home Assistant 操作系统是大多数用户推荐的安装方法。

阅读更多关于 Home Assistant Operating System

Home Assistant Supervised

Home Assistant Supervised 是一个完整的 UI 管理的家庭自动化生态系统,运行 Home Assistant Core 程序、Home Assistant Supervisor 和插件。它预装在 Home Assistant OS 上,但可以独立安装在 Debian Linux 系统上。它利用 Docker,由 Home Assistant Supervisor 管理。

阅读更多关于 Home Assistant Supervised

Home Assistant Supervisor

Home Assistant Supervisor 是一个管理 Home Assistant 安装的程序,负责安装和更新 Home Assistant、插件、它本身以及(如果使用)更新 Home Assistant 操作系统。

阅读更多关于 Home Assistant Supervisor

Host

可以与网络上的其他设备通信的设备。在设置和配置期间,请求主机的输入通常指的是设备的网络地址,以便 Home Assistant 尝试连接到它。这可能是主机名、URL、IP 地址或其他类型的网络标识符。如果您不知道设备的主机名或 IP 地址,可以在路由器的 Web 界面中找到它。例如,如果您的设备是无线连接的,某处有一个页面列出了所有连接到您网络的设备。具体取决于您的路由器,此页面的确切位置可能在网络 > 无线下。

阅读更多关于 Host

I


Image

图像集成允许其他集成显示静态图像。

阅读更多关于 Image

Integration

集成将 Home Assistant 与设备、服务等连接和集成。它们包含处理供应商和设备特定实现的所有逻辑,例如身份验证或特定协议。集成以标准化的方式将这些设备特定元素引入 Home Assistant。例如,Hue 集成将 Philips Hue 桥及其连接的灯泡集成到 Home Assistant 中,使它们作为 Home Assistant 灯实体可供控制。

阅读更多关于 Integration

Intent

意图是与语音助手一起使用的术语。意图是 Home Assistant 从您的语音或文本表达中提取命令时认为您想要它执行的操作。目前,以下意图开箱即用:HassTurnOn、HassTurnOff、HassGetState 和 HassLightSet。这些意图允许您打开或关闭设备、查询状态或更改灯的亮度或颜色。

阅读更多关于 Intent

L


Label

Home Assistant 中的标签允许不考虑其物理位置或类型对元素进行分组。标签可以分配给区域、设备、实体、自动化、场景、脚本和助手。标签可用于自动化和脚本,作为动作的目标。标签还可用于过滤数据。例如,您可以过滤设备列表以仅显示带有“高能耗”标签的设备,或者在没有大量太阳能可用时关闭这些设备。

Light

灯具有您可以控制的亮度,并且可以选择控制色温或 RGB 颜色。

阅读更多关于 Light

Lovelace

Lovelace 是现在称为Home Assistant 仪表板的 UI 的原始代码名称。

M


Matter

Matter 是一个开源标准,定义了如何在 Wi-Fi 或 Thread 网络上控制智能家居设备。该标准的目的是提高安全性并使设备在供应商之间互操作,取代智能家居生态系统的专有协议。与其他标准不同,Matter 允许将同一设备加入多个控制器。例如,您可以同时将灯添加到 Google Home、Apple Home 和 Home Assistant。桥接设备可用于连接运行其他智能家居技术(如 Zigbee 或 Z-Wave)的设备。

阅读更多关于 Matter

N


Notification

您可以使用通知向设备发送消息、图片等。

阅读更多关于 Notification

P


Package

包允许您将不同的组件配置捆绑在一起。

阅读更多关于 Package

Platform

平台是某些集成提供的构建块,可供其他集成使用。例如,Light 集成提供了 light 平台,所有提供 light 实体的集成都使用该平台,例如 Hue

阅读更多关于 Platform

Polling

数据轮询是定期查询设备或服务以检查更新或检索数据的过程。通过定义自定义轮询间隔,您可以控制系统检查新数据的频率,这有助于优化性能并减少不必要的网络流量。

阅读更多关于 Polling

R


Reload

应用对 Home Assistant 配置文件所做的更改。更改通常会自动更新。但是,在前端之外进行的更改不会反映在 Home Assistant 中,需要重新加载。要执行手动重新加载,请转到设置 > 系统 > 重新启动 Home Assistant(右上角)> 快速重新加载。如果您在菜单中看不到快速重新加载选项,则需要在用户设置中启用高级模式。在开发者工具 > YAML 中的YAML 配置重新加载部分中提供了更细粒度的重新加载选项。

S


Scene

场景捕获您希望某些实体处于的状态。例如,场景可以指定灯 A 应该打开,灯 B 应该是亮红色。

阅读更多关于 Scene

Script

脚本是允许用户指定 Home Assistant 打开时要执行的动作序列的组件。

阅读更多关于 Script

Selector

选择器是用户界面的组件。一些选择器可以,例如,显示一个切换按钮来打开或关闭某些东西,而另一个选择器可以过滤设备列表以仅显示具有运动感应功能的设备。

阅读更多关于 Selector

Sensor

传感器返回有关事物的信息,例如水箱中的水位。

阅读更多关于 Sensor

Service

Home Assistant 中的“服务”一词是以信息服务的意义使用的。例如,提供有机物、纸张和包装废物实体的市政废物管理服务。在功能方面,信息服务类似于设备。它被称为服务以避免混淆,因为它不附带硬件。

State

状态保存实体的感兴趣信息。例如,灯是开还是关,当前温度或使用的能量。实体存储与状态相关的 3 个时间戳:last_updatedlast_changedlast_reported。每个实体只有一个状态,并且状态一次只保存一个值。但是,实体可以存储与该状态相关的属性。例如,灯的状态是_开_,相关的状态属性可以是其当前亮度和颜色值。状态更改事件可用作触发器。当前状态可用于条件。

阅读更多关于 State

Switch

开关是具有两种状态的东西,您可以在这两种状态之间进行选择,例如打开或关闭插座。

阅读更多关于 Switch

T


TTS

TTS(文本到语音)允许 Home Assistant 与您对话。

阅读更多关于 TTS

Template

模板是一种自动化定义,可以包括动作或触发值数据的变量。这允许自动化生成动态动作。

阅读更多关于 Template

Thread

Thread 是一种专为智能家居应用设计的低功耗网状网络标准。它是定义设备如何通信的协议。网状拓扑意味着设备可以直接相互通信,而无需先通过中央控制器。Thread 使用与 Zigbee 相同的射频(RF)技术,但提供类似于 Wi-Fi 的 IP 连接。与 Zigbee 不同,Thread 不指定如何控制设备。如何控制 Thread 启用的设备在更高级别的协议中指定,例如 HomeKit 或 Matter。

阅读更多关于 Thread

Thread border router

Thread 边界路由器在本地网络和 Thread 网络之间转发数据包。这使得 Thread 网络中的智能家居设备能够与本地网络中的 IPv6 设备通信。Thread 边界路由器通过 Wi-Fi 或以太网连接到您的网络,并使用其射频(RF)无线电与 Thread 网状网络通信。在 Matter 的情况下,转发的数据是加密的。Thread 边界路由器的示例包括 Nest Hub(第 2 代)、HomePod mini 和 Home Assistant Connect ZBT-1 以及 OpenThread Border Router 插件。

阅读更多关于 Thread border router

Trigger

触发器是定义的一组平台值或条件,用于触发自动化运行。

阅读更多关于 Trigger

U


Update

更新实体是指示设备或服务是否有可用更新的实体。这可以是任何更新,无论是灯泡或路由器等设备的固件更新,还是插件或容器的软件更新。

阅读更多关于 Update

V


Valve

阀门是用于控制液体和气体流动的设备。Home Assistant 中的所有阀门都可以打开和关闭。一些阀门还可以设置为特定位置。

阅读更多关于 Valve

Variables

变量用于在内存中存储值,例如在脚本中处理。

阅读更多关于 Variables

Y


YAML

YAML 是一种人类可读的数据序列化语言。它用于以结构化格式存储和传输数据。在 Home Assistant 中,YAML 用于配置,例如在 configuration.yamlautomations.yaml 文件中。

阅读更多关于 YAML

Z


Zone

区域允许您在地图上指定某些区域。它们启用区域存在检测,并可用于自动化。例如,在您离开家后启动真空吸尘器,或在您离开办公室时启动家中的供暖。

阅读更多关于 Zone