無程式碼也能輕鬆打造專業LINE官方帳號！一鍵導入模板，讓AI助你行銷加分！
Home Assistant 已成为开源家庭自动化的行业标准，将来自数十家制造商的设备统一到单一控制界面中。但与特定生态系统的集成历来依赖于社区开发的插件，这些插件逆向工程通信协议，并在制造商更新固件时失效。Xiaomi Home（ha_xiaomi_home）彻底改变了这种动态：它是由小米自行开发和维护的官方 Home Assistant 集成套件。
这种官方支持意味着集成获得小米工程团队的直接支持、官方 API 的访问权限，以及与当前和未来小米 IoT 设备的保证兼容性。对于数百万小米和米家智能家居用户来说，这项集成架起了小米平价且广泛的设备生态系统与 Home Assistant 强大的自动化引擎之间的桥梁。
该集成支持两种操作模式：通过局域网的米家协议进行本地控制，以及通过小米服务器的云端控制。本地模式提供更低的延迟，即使在互联网中断时也能运行，而云端模式则支持远程访问和需要云端中介的设备。
Xiaomi Home 集成如何运作？
该集成通过多层架构将 Home Assistant 连接到小米 IoT 生态系统。
流程图 TD
A[Home Assistant\n自动化引擎] --> B[ha_xiaomi_home\n集成层]
B --> C{设备发现\nMi Home 协议}
C --> D[局域网\n直接 UDP/ TCP]
C --> E[云端 API\n小米服务器]
D --> F[本地设备\n扫地机 / 灯具 / 传感器]
E --> G[云端设备\n摄像头 / 部分开关]
F --> H[实体注册\nHome Assistant 设备]
G --> H
H --> I[自动化\nHA 脚本与场景]
H --> J[仪表板\nHA Lovelace UI]
H --> K[语音助手\nAlexa / Google Home]
在安装过程中，集成会发现局域网上的小米设备，并通过小米的云端 API 进行验证。设备随后被注册为 Home Assistant 实体，每个设备的能力被映射到适当的 Home Assistant 领域（灯光、传感器、开关、扫地机器人等）。
支持哪些设备以及有哪些功能？
该集成支持小米庞大 IoT 产品线的大部分设备。
| 设备类别 | 示例 | 支持功能 |
|---|---|---|
| 灯具 | 米家 LED 灯泡、吸顶灯、灯带 | 开关、亮度、色温、RGB |
| 传感器 | 人体感应、门窗、温湿度、光照 | 状态监控、电量 |
| 开关与插座 | 智能插座、无线开关、墙壁开关 | 开关、功率监控、定时 |
| 扫地机器人 | 石头、米家扫地机器人 | 启动/停止、返回充电座、区域清扫 |
| 空气净化器 | 米家空气净化器 | 开关、风扇速度、滤网状态 |
| 窗帘 | 米家智能窗帘 | 开/关、位置百分比 |
| 气候设备 | 米家暖气、风扇、除湿机 | 开关、模式、温度设置 |
设备支持通过集成更新持续扩展，且由于集成由官方维护，新小米产品的支持通常比社区替代方案更快。
安装和配置选项有哪些？
集成可通过多种安装路径获取，以满足不同用户的偏好。
| 安装方式 | 难度 | 更新机制 | 备注 |
|---|---|---|---|
| HACS | 简单 | 通过 HACS 自动更新 | 推荐给大多数用户 |
| 手动下载 | 中等 | 手动替换 | 适合没有 HACS 的用户 |
| Home Assistant 附加组件 | 简单 | 自动 | 通过专用附加组件仓库 |
配置需要一个小米账号，并知道设备注册在哪个小米服务器区域。集成支持中国、欧洲、印度、俄罗斯、新加坡和美国服务器。在初始设置中，集成会根据网络特征自动检测服务器区域，但用户可以手动覆盖。
官方集成相较于社区替代方案的优势
在小米发布官方集成之前，Home Assistant 用户依赖社区开发的组件，如 Xiaomi Gateway（Aqara）和 Xiaomi Miot。官方集成提供了以下几个优势。
| 方面 | 官方集成（ha_xiaomi_home） | 社区集成 |
|---|---|---|
| 维护 | 小米工程团队 | 社区志愿者 |
| API 访问 | 官方、有文档的 API | 逆向工程协议 |
| 设备支持 | 保证支持当前小米设备 | 取决于贡献者兴趣 |
| 更新延迟 | 新设备发布后数天至数周 | 数周至数月 |
| 重大变更 | 与固件更新协调 | 意外中断 |
| 认证 | 标准小米账号 | 可能需要设备 Token |
对于在 Home Assistant 内承诺使用小米生态系统的用户来说，官方集成提供了最可靠且面向未来的路径。
常见问题
什么是 Xiaomi Home（ha_xiaomi_home）？ Xiaomi Home 是由小米开发的官方 Home Assistant 集成套件，可让用户直接从 Home Assistant 平台控制小米和米家智能家居设备，同时支持本地网络和云端控制。
有哪些安装方式？ 可通过 Home Assistant 社区商店（HACS）、手动复制自定义组件目录，或直接从 GitHub 仓库下载等方式安装。
支持哪些小米设备？ 该集成支持多种小米和米家智能设备，包括灯具、传感器、开关、插座、扫地机器人、空气净化器、窗帘等，并持续更新以增加新设备支持。
集成支持区域服务器吗？ 是的，集成支持所有小米区域服务器，包括中国、欧洲、印度、俄罗斯、新加坡和美国，安装时会自动检测服务器区域。
本地控制和云端控制有何不同？ 本地控制通过局域网直接与小米设备通信，延迟更低且可在无网络时运行；云端控制则通过小米服务器路由命令，需要互联网连接。
延伸阅读
- ha_xiaomi_home GitHub 仓库 – 官方源代码和文档
- Home Assistant 官方网站 – 开源家庭自动化平台
- Home Assistant 社区商店（HACS） – 推荐的集成安装方式
- 小米 IoT 平台 – 小米官方 IoT 开发者文档
