海尔智家设备接入 HomeAssistant 配置指南
为什么选择该集成方案
该集成插件具有较好的兼容性和易用性。当前版本支持多种实体类型，包括开关、数值、选择器、传感器、二进制传感器、温控器等，基本覆盖了海尔智家的主流设备。
准备工作
在开始安装之前，请确保拥有以下条件：
- 正常运行的 HomeAssistant 系统
- 有效的海尔智家账号
- 设备在线且正常工作
安装方法
方法一：HACS 一键安装
如果已安装 HACS，这是最简单快捷的方式。搜索 "haier" 即可完成安装。
方法二：手动安装
- 下载插件压缩包并解压
- 找到
custom_components/haier文件夹 - 将其完整复制到 HomeAssistant 的
custom_components目录 - 重启 HomeAssistant 服务
方法三：Git 克隆安装
# 克隆仓库至本地
git clone <repository_url>
cd haier
# 复制文件到 custom_components 目录
cp -r . /path/to/homeassistant/custom_components/
配置步骤
- 打开 HomeAssistant 管理界面
- 导航至"配置" → "设备与服务" → "集成"
- 点击"添加集成"按钮
- 在搜索框中输入 "haier"
- 按照提示输入海尔智家账号信息
- 授权设备访问权限
实用场景
智能温控系统
设置自动化规则：当室内温度超过 28 度时，自动开启空调并调节到 26 度；当温度降至舒适范围时，自动关闭空调。
洗衣完成智能提醒
洗衣机工作完成后，系统会自动发送通知到手机，并可设置关闭洗衣机电源。
回家模式自动化
当手机连接到家庭 WiFi 时，自动执行一系列操作：开启客厅空调、调节灯光亮度、播放背景音乐。
故障排除
设备无法被发现
- 确认海尔智家账号密码正确
- 检查设备是否在线且正常工作
- 确保网络连接稳定
状态更新延迟
在 configuration.yaml 文件中添加以下配置来启用调试模式：
logger:
default: warn
logs:
custom_components.haier: debug
功能显示不完整
- 检查插件是否为最新版本
- 查看项目文档了解当前支持的功能列表
