海尔智家 HomeAssistant 集成接入与配置指南
安装方案
HACS 商店安装
适用于已安装 HACS(Home Assistant Community Store)的用户:
- 打开 HACS 管理界面
- 搜索 "haier" 集成项目
- 点击安装按钮并重启 HomeAssistant 服务
手动文件复制安装
适用于对系统有一定了解的用户:
- 下载插件完整文件包并解压缩
- 将
custom_components/haier文件夹复制到 HomeAssistant 根目录下的custom_components文件夹中 - 重启 HomeAssistant 服务完成安装
Git 源码获取
适用于习惯命令行操作的技术用户:
git clone [插件仓库地址]
cd haier
cp -r custom_components/haier /path/to/homeassistant/custom_components/
系统配置
环境准备与前置检查
在开始配置前,请确认您的系统环境满足以下要求:
- HomeAssistant 版本 2023.1 或更新
- 稳定的网络连接环境
- 有效的海尔智家 APP 账号
集成配置步骤分解
完成安装后,按照以下流程进行系统配置:
- 进入系统管理界面
- 导航路径:配置 → 设备与服务 → 集成 → 添加集成
- 搜索选择:在搜索框中输入 "haier" 并选择对应集成
- 账号验证:按照界面提示输入海尔智家账号认证信息
- 设备授权:完成设备扫描和接入授权流程
整个配置过程采用图形化界面操作,无需编写复杂代码。
核心功能架构
设备通信基础框架
插件的核心通信模块位于 custom_components/haier/core/ 目录,负责与海尔智家云平台建立稳定连接。
统一实体管理机制
基础实体类定义在 custom_components/haier/entity.py 文件中,为各类设备提供标准化的接口规范。
多类型设备全面兼容
插件目前支持丰富的设备类型,每种类型都有专门的实现文件:
- 空调温控:
custom_components/haier/climate.py - 电源开关:
custom_components/haier/switch.py - 数据监测:
custom_components/haier/sensor.py - 数值调节:
custom_components/haier/number.py - 模式选择:
custom_components/haier/select.py

