Home Assistant 指南
Home Assistant 指南
这是指南区入口。截图和较长步骤仍在 Home Assistant 集成。
范围
加入开源 Imou Life 集成后，可对开发者账号下的 Imou 视频设备做实时预览、控制和状态查看，并在组件上扩展。它不替代 SaaS / Web / 看板指南。
本书不指定 Home Assistant Core 版本。
前提
- 已运行的 Home Assistant。官方安装：home-assistant.io/installation。
- 海外开发者 AppId 和 AppSecret。
- 与数据中心一致的 API 域名（
openapi-[DataCenter].easy4ip.com）。见 开发规范 第 1 节。
安装 Home Assistant
- 按上面的官方文档部署。
- 在浏览器打开界面并创建账号。
安装 Imou 自定义组件
从下面任一处取包：
- GitHub：Imou-OpenPlatform/Imou-Home-Assistant
- 资源下载 — Imou Home Assistant Component 行（更新 2025-04-01，
resourceType=ImouHomeAssistantComponent）
解压后，把 custom_components/imou 复制到 Home Assistant 配置目录下的 custom_components/imou。
配置凭证
- 设置 → 设备与服务 → 集成。
- 添加集成，搜索 Imou，选择 Imou Life。
- 填入 控制台 · 应用信息 中的
AppId和AppSecret。 - 选择与数据中心一致的 API 域名。使用 开发规范 第 1 节列出的 easy4ip 主机。
确认实体
在集成列表打开 Imou Life，应能看到该开发者账号下的设备。扩展功能见 GitHub 仓库。
更新或卸载
本书没有官方卸载向导，也不指定 Core 版本。
- 更新： 用当前 Downloads 的 hash 对应包或你信任的 GitHub 目录替换
custom_components/imou，再重新加载集成。 - 卸载： 在界面移除 Imou Life 集成，然后删除
custom_components/imou。
排障
| 现象 | 先查 |
|---|---|
| 提交失败 | AppId / AppSecret，以及数据中心对应的 easy4ip 域名。开发规范 |
| 设备列表为空 | 设备已绑到这个开发者账号。通过接口绑定设备 |
| 没有实时画面 | 排障：预览失败 |
截图见 Home Assistant 集成。