★ FEATURED ARTICLE 新手如何把小米米家接入 Home Assistantha_xiaomi_home 集成完整指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home想把小米米家设备接入 Home Assistant却不知该选哪个插件ha_xiaomi_homeXiaomi Home是小米官方支持的集成组件登录账号即可把设备批量导入还支持云端与本地两种控制模式。本文带你走完安装、登录、设备导入与本地控制的全流程。 快速上手安装集成并完成账号登录前置条件Home Assistant 版本Core ≥ 2024.4.4Operating System ≥ 13.0已准备好小米账号米家 App 中设备已正常联网安装三选一HACS 一键安装推荐在 HACS 搜索框输入Xiaomi Home进入详情页点击 DOWNLOAD。git clone 安装把仓库克隆到 HA 的 config 目录并运行安装脚本方便通过切换 tag 回退到指定版本。git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config手动安装把custom_components/xiaomi_home文件夹复制到config/custom_components目录下。安装完成后重启 Home Assistant再按以下路径登录并导入设备进入设置 设备与服务 添加集成搜索Xiaomi Home。选择登录入口用小米账号完成 OAuth 登录。登录后弹出「选择家庭与设备」勾选要导入的米家家庭该家庭设备即被导入。⚠️ 版本要求是硬门槛Core 低于 2024.4.4 的 Home Assistant 无法安装本集成。 ⚠️ 登录成功后账号 token、证书等信息会明文保存在 HA 配置文件中请自行保管如怀疑令牌泄露可在米家 App 的账号授权页取消「Xiaomi Home」授权。 功能拆解看懂集成怎么控制设备云端控制订阅机制让状态实时更新默认模式下所有指令都经小米云转发。集成向云端 MQTT Broker 订阅设备消息设备属性变化或事件发生时由云端实时推送无需轮询。得益于这套订阅机制集成只在配置完成时向云端查询一次全部设备属性之后靠消息订阅更新对云端压力小出门在外也能远程查看与控制。图云端控制架构集成经小米云 MQTT 订阅设备状态、经 HTTP 接口下发指令本地控制中枢网关让指令不出内网若家中有小米中枢网关固件 3.3.0_0023 及以上或内置中枢网关的设备软件 0.8.9 及以上集成可借助网关内置的 MQTT Broker 直接收发指令不经过小米云。断网时局域网内设备仍可控制链路更短需注意中枢网关目前仅在中国大陆可用。图本地控制架构经小米中枢网关内置 MQTT Broker 收发指令不经过云端设备自动映射米家设备直接变 HA 实体集成会解析设备的 MIoT-Spec-V2 规范把属性、事件、方法自动转换成 Home Assistant 实体可写布尔属性变成开关只读属性变成传感器带参数的事件变成事件实体带参数的方法变成通知实体。导入设备即自动生成对应实体可直接用于自动化。目前蓝牙、红外与虚拟设备暂不支持。 实战场景三条常用联动人来灯亮门口人体传感器检测到移动 → 客厅灯开启超时自动关闭。温度越界自动调空调温湿度传感器读数高于阈值 → 空调切到制冷低于阈值 → 切到制热。门窗异常即时推送门窗磁传感器触发事件 → 经通知实体发送提醒并可联动摄像头等安防动作。⚠️ 避坑指南高频问题与解决思路设备加不进来或某些设备不显示确认米家 App 中该家庭已添加且设备在线蓝牙、红外、虚拟设备本就不支持。多个家庭可在「选择家庭与设备」里分别勾选导入。本地控制没生效本地模式依赖小米中枢网关固件 3.3.0_0023或内置中枢网关设备软件 0.8.9且仅中国大陆可用局域网控制只覆盖 IP 设备与中枢网关并存时也不会生效官方建议谨慎开启。改了规则文件没反应修改custom_components/xiaomi_home/miot/specs下的文件后需在集成配置页执行「更新实体转换规则」才生效。更多细节可查阅 doc/ 目录与 更新日志。ha_xiaomi_home 适合手里有一批米家设备、想在 Home Assistant 里做统一控制与跨品牌联动的用户。建议先用 HACS 装好并完成一个家庭的设备导入跑通基础自动化后再逐步接入中枢网关体验本地控制。贡献与开发说明见 CONTRIBUTING.md。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
