HA文档 目录

  1. 首页
  2. 文档
  3. HA文档
  4. 配置进阶
  5. 实体自定义(customize)

实体自定义(customize)

实体是由组件程序生成的,同时组件程序会决定实体在前端的显示特性(是否可见、图标、名称等)。但我们也可以事后对实体的特性进行自定义,这些自定义属性会覆盖实体生成时的属性,从而改变其(显示)特性。
实体自定义往往用于前端更人性化的显示,例如,将程序定义的实体英文名改为看了就明白的中文名。

自定义实体属性在基础信息配置(homeassistant域)中,通过customize进行定义。
这部分我们在基础配置信息中已经有了初步介绍,在本章节中会更完整的介绍实体可自定义的属性值及其意义。

属性 描述
friendly_name 前端显示的名称,可以是中文
homebridge_name 在HomeBridge中显示的名称
hidden 如果设置为true,前端将隐藏此实体(不显示)
homebridge_hidden 如果设置为true,HomeBridge将不显示此实体
emulated_hue_hidden 如果设置为true,emulated_hue将不显示此实体
entity_picture 实体图片的URL
icon 实体的图标,可以在MaterialDesignIcons.com(http://materialdesignicons.com/)中查找需要的图标,以mdi:xxx格式设置,例如:mdi:home
assumed_state 对于灯与开关这类实体,在一些情况下系统可能并不能准确获知其开关状态。当此值为true时,前端将显示打开和关闭两个按钮,而此值为false时,将显示为一个开关
device_class 设置设备的种类,改变前端状态与icon的显示。目前仅支持Binary_SensorCover两种组件下的平台设备。
initial_state 设置自动化规则的初始状态,on或者off
unit_of_measurement 定义状态值的单位

 

【编辑自定义】
在缺省的配置文件configuration.yaml中,定义了customize: !inclue customize.yaml,因此,我们可以编辑customize.yaml进行自定义。
例如:

自定义实体属性,也可以在前端“配置(Configuration)”菜单中的“自定义(Customziation)”中进行,如下图。

【让自定义起作用】
重启整个hass程序可以让编辑的自定义起作用,但也可以仅通过重新加载核心(core)使自定义起作用。
我们可以在前端“配置(Configuration)”菜单中的“通用(General)”,点击“重载核心配置(reload core)”重新加载核心配置。

我们也可以在前端的开发者工具中,点击服务按钮,调用homeassistant.reload_core_config服务,重新加载核心配置。
定制的属性,会在实体状态下一次更新时体现。

遇到问题了?快来学习免费在线课程吧,博学老司机在线答疑,找到更多志同道合的HA玩家一起进步

此文不允许转载,如需转载请与BD@hachina.io联系。

以上内容是否对您有帮助? 0 有帮助 0 没帮助