Home Assistant Floor Plan 项目教程
1. 项目的目录结构及介绍
home-assistant-floor-plan/
├── README.md
├── floorplan.py
├── config/
│ ├── example_config.yaml
│ └── custom_components/
│ └── floorplan/
│ ├── __init__.py
│ └── manifest.json
└── static/
└── images/
└── example_floorplan.png
- README.md: 项目说明文件,包含项目的基本信息和使用指南。
- floorplan.py: 项目的主启动文件,负责加载和运行地板图界面。
- config/: 配置文件目录,包含示例配置文件和自定义组件。
- example_config.yaml: 示例配置文件,展示了如何配置地板图。
- custom_components/floorplan/: 自定义组件目录,包含地板图组件的实现。
- init.py: 自定义组件的初始化文件。
- manifest.json: 自定义组件的清单文件,包含组件的元数据。
- static/images/: 静态资源目录,包含地板图的图片文件。
- example_floorplan.png: 示例地板图图片。
2. 项目的启动文件介绍
floorplan.py 是项目的启动文件,负责初始化和运行地板图界面。该文件主要包含以下功能:
- 加载配置文件。
- 初始化地板图界面。
- 监听Home Assistant的状态变化,并更新地板图。
3. 项目的配置文件介绍
config/example_config.yaml 是项目的示例配置文件,展示了如何配置地板图。主要包含以下配置项:
- floorplan_image: 地板图的图片路径。
- entities: 需要显示在地板图上的实体列表,每个实体包含以下属性:
- entity_id: 实体的ID。
- x: 实体在地板图上的X坐标。
- y: 实体在地板图上的Y坐标。
- icon: 实体在地板图上显示的图标。
示例配置文件内容如下:
floorplan_image: /local/floorplan.png
entities:
- entity_id: light.living_room
x: 100
y: 200
icon: mdi:lightbulb
- entity_id: switch.kitchen
x: 300
y: 400
icon: mdi:switch
通过以上配置,可以在地板图上显示指定位置的实体,并根据实体的状态更新图标。