小米官方发布「米家集成」，可在 Home Assistant 中使用小米 IoT 智能设备

小众软件

作者青小蛙

2024年12月17日 16:04

米家集成是由小米官方发布的 Home Assistant 集成组件，在登录米家账号之后，可以在 Home Assistant 中使用小米 IoT 智能设备，NAS 党狂喜。@Appinn

小米官方发布「米家集成」，可在 Home Assistant 中使用小米 IoT 智能设备 31

Home Assistant 是什么？

Home Assistant（官网）是一个开源的智能家居自动化平台，通过一个统一的界面（网页、手机客户端）来管理和控制家中的智能设备（支持不同品牌如宜家、飞利浦、亚马逊等），还支持自动化设置，可根据自己的需求创建智能场景。

在此之前想要将米家的设备接入 Home Assistant 是一件十分复杂且挑设备的事情，而今后就不同了。

以下内容转自米家集成的 GitHub 中文介绍页面：

米家集成（3 种安装方式）

米家集成作为一个 Home Assistant 的集成组件，直接安装在 Home Assistant 中。你需要先安装 HA，然后才能安装米家集成。

Home Assistant 版本要求：

Core ≥ 2024.11.0
Operating System ≥ 13.0

米家集成的说明文档中提供了三种安装方式：

命令行

cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config

可以很方便的切换版本：

cd config/ha_xiaomi_home
git checkout v1.0.0
./install.sh /config

通过 HACS 商店安装

尚未添加到商店中，但可以在 HACS 中：HACS > Overflow Menu > Custom repositories > Repository: https://github.com/XiaoMi/ha_xiaomi_home.git & Category: Integration > ADD

手动安装

下载并将 custom_components/xiaomi_home 文件夹复制到 Home Assistant 的 config/custom_components 文件夹（没有就创建一个）下。

相对来说，这个方法可能更简单一些。帮你们打了个包：扫码关注小众软件微信公众号，回复 241217 获取网盘链接：

小米官方发布「米家集成」，可在 Home Assistant 中使用小米 IoT 智能设备 32

安装完成之后，记得重启 Home Assistant

配置

添加 MIoT 设备

登录成功后，会弹出会话框“选择家庭与设备”。您可以选择需要添加的米家家庭，该家庭内的所有设备将导入 Home Assistant 。

多账号登录

用一个小米账号登录并配置完成后，您可以在 Xiaomi Home Integration 页面中继续添加其他小米账号。

方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 添加中枢 > 下一步 > 请点击此处进行登录 > 使用小米账号登录

Open your Home Assistant instance and show an integration.

修改配置项

在会话框“配置选项”中，可选择需要变更的配置项。您可以修改用户昵称或更新从米家 APP 导入的设备列表。

方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 选择需要变更的配置项

Action 调试模式

开启该模式后，您可手动向设备发送带参数的 Action 控制指令。发送带参数的 Action 控制指令的用户入口显示为一个文本实体。

方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > Action 调试模式

安全性

米家集成及其使用的云端接口由小米官方提供。您需要使用小米账号登录以获取设备列表。米家集成使用 OAuth 2.0 的登录方式，不会在 Home Assistant 中保存您的小米账号密码。但由于 Home Assistant 平台的限制，登录成功后，您的小米用户信息（包括设备信息、证书、 token 等）会明文保存在 Home Assistant 的配置文件中。因此，您需要保管好自己 Home Assistant 配置文件。一旦该文件泄露，其他人可能会冒用您的身份登录。

常见问题

米家集成是否支持所有的小米米家设备？

米家集成目前支持大部分米家设备品类，但仍有一小部分设备品类（蓝牙、红外及虚拟设备）并不支持。

米家集成是否可以同时使用多个小米账号？

是的，米家集成支持多个小米账号同时登录。另外，米家集成还支持不同账号的米家设备添加至同一个 Home Assistant 区域。

米家集成是否支持本地化控制？

米家集成支持通过小米中枢网关（固件版本 3.4.0_000 以上）或内置中枢网关（软件版本 0.8.0 以上）的米家设备实现本地化控制。如果没有小米中枢网关或其他带中枢网关功能的设备，那么所有控制指令都会通过小米云发送。支持 Home Assistant 本地化控制的小米中枢网关（含内置中枢网关）的固件尚未发布，固件升级计划请参阅 MIoT 团队的通知。

小米中枢网关仅在中国大陆可用，在其他地区不可用。

米家集成也能通过开启小米局域网控制功能实现部分本地化控制效果。小米局域网控制功能只能控制与 Home Assistant 处于同一局域网内的 IP 设备（使用 WiFi、网线连接路由器的设备），无法控制蓝牙 Mesh、ZigBee 等协议接入的设备。该功能可能会引起一些异常，我们建议不要使用该功能。小米局域网控制功能开启方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 更新局域网控制配置

小米局域网控制功能不受地区限制，在全球范围内均可用。如果 Home Assistant 所在的局域网内存在中枢网关，那么即便米家集成开启了小米局域网控制功能，该功能也不会生效。

米家集成在哪些地区可用？

米家集成所用的云服务接口已部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国共六个地区的机房。由于用户数据在不同地区的小米云上相互隔离，您需要在配置 Home Assistant 时选择用户所在地区，才能导入相应的米家设备。米家集成支持将不同地区的米家设备添加至同一个 Home Assistant 区域。

更多详见项目主页：https://github.com/XiaoMi/ha_xiaomi_home/

另外，我们建立了一个群组，感兴趣的同学可以一起来讨论：

小米官方发布「米家集成」，可在 Home Assistant 中使用小米 IoT 智能设备 34

注意，在安装过程中问题还是不少，可能要折腾一段时间，比如，我卡在了登录这里：

小米官方发布「米家集成」，可在 Home Assistant 中使用小米 IoT 智能设备 35

如果你也是，将 ip homeassistant.local 添加到 hosts 文件里（或者在地址里换一下 URL）

这大概是 NAS 党又一个不得不装的工具啊。

普通视图