先说痛点

上一篇我们装好了 Home Assistant 和 HACS，用 Xiaomi Miot Auto 接入了米家设备。能用，但用了一段时间你会遇到：

• 米家固件更新后，HA 里设备偶尔显示「不可用」，得重启集成
• 新买的米家设备，Miot Auto 要等社区更新才能识别
• 每隔几个月 token 过期，设备全掉，手动刷新才能恢复

这些问题的根源：Miot Auto 是第三方逆向的 API，小米随时可能改接口。

现在小米官方出了 Home Assistant 集成——ha_xiaomi_home，直接从源头解决问题。

官方 vs 第三方，到底差在哪？

不是简单的「官方更好」，实际差异在这里：

结论：不是谁替代谁，而是互补。 我目前的方案是：WiFi 设备用官方集成（稳定），蓝牙 Mesh 设备用 Miot Auto（兼容好），两个共存不冲突。

安装步骤

前提条件

• Home Assistant Core ≥ 2024.4.4，Operating System ≥ 13.0
• HACS 已安装（上一篇文章已经教过怎么装）

第一步：在 HACS 中安装

1. 左侧点击 HACS
2. 搜索框输入 Xiaomi Home
3. 点击 下载，确认安装
4. 重启 HA （必须重启，不然不会生效）

如果你的 HA 版本 ≥ 2024.11.0，可能已经内置了这个集成，直接跳到第二步。

第二步：添加集成

1. 进入 设置 → 设备与服务 → 添加集成
2. 搜索 Xiaomi Home
3. 点击卡片中的 「请点击此处进行登录」
4. 跳转到小米官网，用小米账号登录（OAuth2 授权，不会保存你的密码）
5. 登录后选择你的 服务器区域（中国大陆/欧洲/印度/俄罗斯/新加坡/美国）
6. 选择要导入的 家庭和设备
7. 点击完成

重要提醒： 服务器区域必须选对！你米家 App 里设备在哪个区域，这里就选哪个。选错了看不到设备。

第三步：确认设备

导入完成后，进入 设置 → 设备与服务 → Xiaomi Home，检查设备列表是否完整。

第四步：开启局域网控制（可选）

如果你有小米中枢网关（固件 ≥ 3.3.0），可以开启本地控制：

设置 → 设备与服务 → Xiaomi Home → 配置 → 更新局域网控制配置

开启后，支持局域网控制的设备断网也能用，响应速度更快。

没有中枢网关？没关系，控制指令走小米云端，一样能用，只是断网后不可控。中枢网关目前仅在中国大陆销售。

设备支持情况

我实际测试接入的设备：

稳定可用：

• ✅ 吸顶灯、灯泡、灯带——开关、亮度、色温全支持
• ✅ 智能插座/开关——开关控制、电量统计
• ✅ 空调伴侣——温度、模式、风速
• ✅ 窗帘电机——开合控制、百分比
• ✅ 扫地机器人——开始/回充/清扫模式
• ✅ 空气净化器/加湿器——开关、模式、滤芯寿命

有限支持：

• ⚠️ 蓝牙温湿度传感器——需要通过中枢网关或蓝牙 Mesh 网关中转，稳定性一般
• ⚠️ 蓝牙 Mesh 开关——部分用户反馈接入后会断连，建议先用 Miot Auto

暂不支持：

• ❌ 门锁（安全设备，接入方案复杂）
• ❌ 蓝牙设备直连（无网关情况下）

实际能玩什么？

设备接入后，重点是可以和其他品牌设备联动。我实际在用的几个自动化：

场景 1：人来灯亮（跨品牌联动）

米家人体传感器 + HomeKit 灯泡：

触发：米家人体传感器检测到人
条件：光照度 
动作：打开 HomeKit 灯泡，亮度 80%

场景 2：空调语音控制

把米家空调暴露给苹果 HomeKit，然后用 Siri 控制：

• 「嘿 Siri，把卧室空调调到 24 度」
• 「嘿 Siri，关闭空调」

不用打开任何 App，说句话就行。

场景 3：离家自动关设备

触发：手机断开 WiFi 超过 5 分钟
条件：工作日白天
动作：关闭所有灯 → 关闭空调 → 扫地机开始清扫

安全提醒

官方集成用的是小米 OAuth2 授权，不会保存你的小米密码。但有一个要注意的点：你的小米账号 token 会明文保存在 HA 的配置文件里。

这意味着：

• 如果有人能访问你的 HA 服务器配置文件，就能拿到你的小米 token
• 建议做好 HA 服务器的访问安全（改默认密码、开防火墙）
• Docker 部署的话，确保 config 目录权限设置正确

这点 Miot Auto 也一样，不是官方集成特有的问题。只是提醒一下，安全意识要有。

常见问题

Q：官方集成免费吗？要开小米会员吗？ 

A：完全免费，小米官方开源维护，不需要任何付费。GitHub 仓库：XiaoMi/ha_xiaomi_home

Q：和 Miot Auto 能同时装吗？会冲突吗？ 

A：可以同时装，不冲突。建议同一设备只用一种方式接入，避免重复实体。WiFi 设备用官方集成，蓝牙设备用 Miot Auto。

Q：需要一直联网吗？ 

A：首次授权需要联网。日常使用：有中枢网关的走局域网，没有的走小米云端（也要联网）。断网情况下，只有开启了局域网控制的设备才能用。

Q：支持哪些国家/地区？ 

A：中国大陆、欧洲、印度、俄罗斯、新加坡、美国，共 6 个区域的服务器。不同区域的设备数据是隔离的，需要分别配置。

Q：设备太多，能选择性导入吗？ 

A：可以。最新版本支持按家庭筛选设备，不用全量导入。如果你有不想在 HA 里出现的设备，可以在导入时取消勾选。

Q：Token 过期了怎么办？ 

A：官方集成的 OAuth2 会自动刷新 token，正常使用不会过期。如果长时间没用 HA 或者改了小米密码，可能需要重新授权，按提示操作即可。

设备都接入好了，下一步就是让这些设备「可视化」。下一篇文章教你用 Sweet Home 3D 画一个家里的 3D 户型图，导入 HA 之后，哪个灯亮着、哪个房间温度高，拖一拖鼠标就能看到——比一堆卡片直观多了。点个关注，不错过后续更新 👇

你现在用的是 Miot Auto 还是官方集成？接入了哪些设备？评论区晒出你的 HA 设备列表，看看谁的智能家最「卷」 👇