小米智能家居设备接入 Home Assistant 怎么做Xiaomi Home 集成实操指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeXiaomi Home 集成米家集成是小米官方维护的 Home Assistant 组件可以把灯光、空调、传感器等米家 IoT 设备直接导入 Home Assistant并支持走小米云或中枢网关本地控制两条通道。无论你是刚接触 Home Assistant 的新手还是已有米家设备、想把它们纳入自己自动化体系的用户这篇指南都能带你从安装走到日常使用。米家联动不够用时米家设备平时分散在米家 App 里管理想让日落时空调和客厅灯一起动作或者摄像头检测到移动后触发音箱播报这类跨生态联摆在米家 App 里很难搭出来。Home Assistant 的自动化引擎擅长这件事但前提是要先看见你的设备。Xiaomi Home 集成解决的就是这一段一次登录之后它把米家设备逐个转成 Home Assistant 实体——开关、灯、空调、扫地机、媒体播放器等之后就能用平时的场景和脚本。它支持多个小米账号同时登录不同账号下的设备也能放进同一个区域。两条通信链路云端稳、本地快默认情况下集成走小米云它向云端的消息代理订阅设备状态变化设备一有变化就立刻推送过来不用反复轮询。云端服务部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个地区配置时选择你所在的地区否则看到的设备列表不对。控制指令则由 Home Assistant 经云端 HTTP 接口发给设备。家里有中枢网关或内置中枢的设备时还有一条更直接的链路网关内置消息代理支持完整的订阅/发布机制集成直接在局域网内收发消息指令不出家门。条件是中继网关固件 3.3.0_0023 及以上或内置中枢设备的软件版本 0.8.9 及以上中枢网关硬件目前仅在中国大陆销售。安装从零到设备列表版本要求Home Assistant Core ≥ 2024.4.4Operating System ≥ 13.0。三种装法把仓库克隆到config目录并运行安装脚本推荐之后切换 Tag 即可换版本cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config在 HACS 中搜索 Xiaomi Home 一键安装手动把custom_components/xiaomi_home文件夹复制到config/custom_components。装好后进入设置 设备与服务 添加集成搜 Xiaomi Home用小米账号登录OAuth 2.0不保存密码。登录后在选择家庭与设备弹窗里勾选要导入的家庭该家庭下设备即批量导入。登录流程实现在 config_flow.py 中。区域划分把米家房间映射成区域选择家庭与设备这一步还有一个区域名称映射选项默认拿米家 App 里的房间名当区域名也可以换成家庭名、家庭名房间名组合或干脆不挂任何区域逻辑见 miot_device.py。设备散布在多个房间时保持默认映射Home Assistant 里的区域划分就和 App 里一致写自动化时好认路。进阶可以玩的两个开关实体转换与过滤MIoT-Spec-V2 转 Home Assistant 实体的规则集中在 specs/spec_filter.yaml 等文件例如可写的布尔属性变 Switch、只读属性变 Sensor、无参数方法变 Button。不想生成某些设备或实体时可在配置选项里调整过滤规则。Action 调试模式高级选项里打开后带参数的 Action 会多出一个文本实体输入形如[Hello, true]的参数即可直接向设备发指令适合验证设备能力和调试自动化。最后说两句一条命令装好、登录、勾选家庭米家设备就会出现在 Home Assistant 里有中枢网关时本地控制还自动就位。如果你已经装好 Home Assistant照着上面的安装一节走一遍就能开始。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考