3 步把米家设备搬进 Home Assistant小米智能家居统一控制指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home灯、锁、空调散在三个 App一个集成全接住Xiaomi Home 集成ha_xiaomi_home是小米官方支持的 Home Assistant 组件把米家设备统一搬进 HA一个界面全管。你肯定有过这种时刻开灯切米家 App看门锁切小米 App调空调又翻回去。更难受的是想写个自动化发现 HA 里根本找不到这些设备。装好这个集成后灯、门锁、空调、传感器全出现在 HA 里还能串进自动化人进家自动亮灯温度一过 28 度空调自己开。最快路径3 步装好就能用先确认一个条件Home Assistant 核心版本 2024.4.4 及以上。满足的话照下面走。第 1 步把组件放进 HAcd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config[!TIP] install.sh 会自己把组件拷到 HA 的自定义组件目录然后重启 HA 就行。你的配置目录不叫 /config把路径换掉即可。第 2 步小米账号登录设置 设备与服务 添加集成搜索 Xiaomi Home按提示登录小米账号。这里走的是 OAuth 授权账号密码不会留在本地放心。第 3 步选家庭完事登录后弹出选择家庭与设备挑一个家庭里面的设备就全导进来了。给设备命名、分到房间打开设备页验收灯、传感器、空调都整整齐齐。米家云端控制 vs 本地控制背后怎么转的装好之后它是怎么和设备说话的两条路很像寄快递和当面交接。云端模式像寄快递。HA 把指令交给小米云云再转给设备设备状态变了也是先回云端再推给 HA。好处是你在外地也能控家代价是速度看网络脸色。整个登录授权过程由 config_flow.py 里的流程驱动你只管点下一步。本地模式像当面交接。家里有小米中枢网关的话它相当于屋里的快递站指令从 HA 直接发到站里站再递给设备全程不出家门。状态推送是实时的点一下开关灯就亮明显比绕云快。找网关不用你输 IP。miot_mdns.py 负责在局域网里自动发现中枢网关发现到就走本地找不到就回云端。 核心要点云端零门槛能远程控制速度看网络本地需要中枢网关指令走局域网快且稳两种模式自动配合平时不用管它多账号、切本地、改名字3 个高频场景两个小米账号设备各管一半家里设备分在两个账号里的别把其中一个晾着。进设置 设备与服务 已配置 Xiaomi Home点添加中枢再登一次另一个账号。两个账号的设备能放进同一个房间自动化照常写不用改。想把云端切成本地前提是设备里有中枢网关独立的小米中枢网关固件 3.3.0_0023 及以上或者内置中枢功能的米家设备。然后到 Xiaomi Home 配置里把本地模式打开切过去就行。[!WARNING] 小米中枢网关目前只有国行版。人在海外的话安心用云端模式别折腾局域网控制。没有网关时还有个局域网控制选项直连同一网段内的 IP 设备。但蓝牙 Mesh、Zigbee 设备它管不了官方也不推荐开没网关又非要用再考虑。实体名字是机翻乱码有些设备的名字在 HA 里显示得不太人类。打开 multi_lang.json按里面的格式补上你想用的名字再到 Xiaomi Home 配置 更新实体转换规则刷新即生效。省下的不只是切换 App 的功夫米家集成帮你省掉的是对接协议的折腾、来回切 App 的功夫和再买个别家设备的冲动装一次全家接管。目前蓝牙、红外类设备还不在支持范围内属已知边界。想修个翻译错误或者给缺的品类补支持先看 CONTRIBUTING.md 里的贡献指南改完用 test/ 目录里的脚本验一遍再提交。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考