ha_xiaomi_home 使用指南：把米家设备接入 Home Assistant 的最短路径

ha_xiaomi_home 使用指南把米家设备接入 Home Assistant 的最短路径【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home如果你手里有一堆小米智能设备又用 Home Assistant 做家庭自动化那么 ha_xiaomi_home 就是两者之间的桥梁。这个由小米官方支持的集成组件能让米家 App 里的灯泡、插座、空气净化器等设备直接出现在 Home Assistant 中参与你的自动化流程。本文面向第一次尝试接入的读者讲清楚准备什么、怎么装、以及它为什么能实时感知设备状态。接入后你能得到什么最直接的收益是一套设备两个入口。设备照常在米家 App 里管理同时它们以标准实体的形式进入 Home Assistant开关灯、查湿度、看门锁状态都能写成自动化或交给语音助手。对多账户家庭也有实际意义集成支持登录多个小米账号还能把不同账号下的设备放进同一个 Home Assistant 区域统一管理。另外接入完成后集成会根据小米 MIoT 规范自动为设备生成实体灯有亮度颜色、空调有温度档位不需要你手动逐台定义。接入前需要准备什么Home Assistant 版本Core 2024.4.4 及以上或 Operating System 13.0 及以上。一个小米账号登录用的是 OAuth 2.0 授权流程类似第三方应用授权登录集成本身不保存你的账号密码。设备范围大部分米家品类都支持但蓝牙设备、红外设备和虚拟设备不在支持列表内。地区云服务接口部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国配置时需要选择账号所在地区。有一点要提前知道登录成功后你的设备信息、令牌等会明文存放在 Home Assistant 的配置文件里所以配置文件本身要保管好。最快跑起来的步骤官方推荐用 git 方式安装因为以后想切换特定版本时最方便。在你的 Home Assistant 服务器上执行cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config不想折腾命令行也可以在 HACS 商店里搜索Xiaomi Home一键安装或者把custom_components/xiaomi_home文件夹手动复制进你的config/custom_components目录。装好后进入 Home Assistant 的设置 设备与服务 添加集成搜索 Xiaomi Home 并用小米账号登录然后弹出选择家庭与设备对话框勾选要导入的家庭即可。整个过程不需要手写任何配置文件。设备状态是怎么实时同步的默认情况下走云端链路。集成向小米云的 MQTT Broker 订阅你关心的设备消息——MQTT 可以理解为一个设备消息广播站设备一有变化属性改变、产生事件、上下线消息就会主动推给集成而不是集成反复去云端问一次。控制方向相反你在 Home Assistant 里下发指令时集成通过小米云的 HTTP 接口把命令发给设备。一推一拉状态刷新快对云端的访问压力也不大。如果你家有小米中枢网关固件 3.3.0_0023 及以上或者设备本身内置中枢网关功能软件 0.8.9 及以上链路就变成纯本地网关内部自带一个 MQTT Broker状态推送和控制下发都不出你家网络延迟更低也不依赖外网。需要留意的是中枢网关目前仅在中国大陆销售。官方还提供局域网控制开关作为替代但它只能管同一局域网里的 Wi-Fi/网线设备管不了蓝牙 Mesh 和 ZigBee 设备且官方并不建议使用。适合谁不适合谁米家设备为主、想统一进 Home Assistant 做自动化正合适。家里设备以蓝牙、红外协议接入这套集成帮不上忙需要另找方案。位于上述六个地区之外、或账号数据在特殊区域可能无法导入设备具体以仓库文档为准。几个实用提示想更新到某个固定版本用 git 方式直接git checkout对应标签再运行一次安装脚本即可。怀疑授权信息泄露时可以在米家 App 的账号管理 应用授权里取消 Xiaomi Home 的授权。想手动给设备发带参数的控制指令测试行为可以在集成配置里开启Action 调试模式会多出一个文本实体作为发送入口。更完整的实体映射规则和设备支持清单可以直接查阅仓库里的 README。一句话总结ha_xiaomi_home 把米家设备和 Home Assistant 的连接变成了登录 勾选两步状态同步靠消息推送而非轮询有中枢网关还能走纯本地链路。如果你的设备在支持范围内现在就可以按上面的最短路径装起来试试。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考