米家设备接入Home Assistant终极指南：用ha_xiaomi_home让全屋设备统一听你指挥
米家设备接入Home Assistant终极指南用ha_xiaomi_home让全屋设备统一听你指挥【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home晚上十一点半卧室灯光要调到最暗、空调要切到睡眠模式、客厅插座要断电、门锁要确认落锁——这一串动作如果还靠你拿起手机、在米家App里逐页寻找设备少说也要花上五分钟。而装上 ha_xiaomi_home 之后这些事可以浓缩成一句语音、一个按钮甚至一条全自动触发的场景。它是小米官方支持的 Home Assistant 集成组件能把米家账号下几乎全系的智能设备接入 Home Assistant从此灯光、空调、传感器、门锁都在同一个平台上协同工作。下面这份指南是我从在十个App之间来回横跳到一个面板全搞定的完整经验希望能帮你少走弯路。先看结果那个不用打开任何App的早晨我改造完家里的智能家居后记下了这么一个普通早晨07:00卧室窗帘在闹钟响起前缓缓拉开灯光用十分钟从1%慢慢亮到30%模拟日出。我拿起床头的平板看了一眼——不对我压根没看因为一切都在按场景运行。出门前喊了一声离家全屋灯光熄灭、空调进入节能模式、扫地机器人开始工作、摄像头布防。放在几个月前这套流程需要我打开米家App关灯、再切到另一个App看摄像头、再打开第三个App调空调。现在呢设备还是那些设备变化的只是它们被装进了同一个系统。场景改造前改造后早上开灯摸到手机打开App逐盏调节一句话或一个场景自动渐变亮起离家锁门逐个检查设备状态喊一声离家全屋联动睡觉前在几个App之间反复切换一键睡眠模式批量执行传感器联动基本做不到跨平台人体传感器直接触发灯光和空调带来这种变化的就是 ha_xiaomi_home。它把小米设备从米家App的私有世界里解放出来放进了 Home Assistant 这个开放生态——你可以把小米的灯具、插座、传感器和任意其他品牌的设备放在同一个自动化里互相触发、协同工作。它到底是什么凭什么值得装简单说ha_xiaomi_home 是小米官方提供的 Home Assistant 集成组件你只需要登录自己的小米账号组件就会把账号下的智能设备自动导入 Home Assistant自动转换成对应的实体开关、传感器、灯、空调等。和社区里那些靠逆向协议打通的第三方方案相比它有三个明显的底气✅官方支持登录走的是小米官方 OAuth 2.0 授权流程设备通讯用的是官方 MIoT 协议稳定性和兼容性有保障而且持续更新。✅导入即用不需要手工配置设备型号、不填token、不写yaml映射登录、选家庭、完事。✅跨区域跨账号中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个区域的设备都能导入而且支持多个小米账号共存不同账号的设备还能放进同一个房间。两种工作模式走云端的快递 vs 走家里的对讲机这是 ha_xiaomi_home 最值得说的设计——它给了你两条控制通路你可以按自己的需求选。第一条云端模式随时随地。设备状态变化时小米云会把消息实时推送给 Home Assistant你要下发指令指令先送到云端再由云端转发给设备。整个过程不需要你干预出门在外也能远程控制代价是依赖外网、有一点点延迟。第二条本地模式毫秒级响应。如果你家里有一台小米中枢网关固件3.3.0及以上网关内置了标准 MQTT Broker设备和 Home Assistant 之间的通信全程在局域网内完成不经过任何外部服务器。这就像和邻居隔墙喊话比绕一圈云端快得多隐私也更好。怎么理解这两张图你可以把云端模式想象成发快递包裹指令先到中转站小米云再派送给收件人设备可靠但多一道工序。本地模式则是对讲机网关里的 MQTT Broker 就是基站设备状态一有变化消息瞬间送达。想要快速响应的场景——比如人体传感器触发灯光、湿度变化启动加湿器——本地模式明显更合适。十分钟上车最快的安装与配置路线先确认一个前提Home Assistant Core 版本不低于 2024.4.4。满足之后有三种安装方式任选其一。方式一命令行克隆我最推荐方便日后切换版本git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/homeassistant/config方式二HACS 一键安装。在 HACS 商店搜索 Xiaomi Home进入详情页点击下载即可适合习惯用 HACS 管理组件的朋友。方式三手动拷贝。把custom_components/xiaomi_home整个文件夹复制到 Home Assistant 配置目录下的custom_components/里。装完重启 Home Assistant接下来就是见证奇迹的时刻进入设置 设备与服务点击添加集成搜索 Xiaomi Home。按提示用小米账号登录OAuth 2.0 授权不会保存你的账号密码。登录后选择家庭与设备组件会把该家庭下的所有设备批量导入。整个过程大约五分钟。导入完成后你会在设备列表里看到成排的小米设备——灯、插座、传感器、空调伴侣、加湿器……它们已经全部变成了 Home Assistant 能识别的实体。如果你在多个区域有设备或想加入第二个小米账号也可以在集成配置页里继续添加中枢把不同账号、不同区域的设备合并到同一个房间管理。藏在背后的同声传译MIoT-Spec-V2 怎么变成实体你可能会好奇小米设备那么多型号五花八门组件是怎么自动把它们变成 Home Assistant 实体的关键在于小米的 MIoT-Spec-V2 协议。你可以把它理解成一份标准的设备说明书每台设备由若干服务组成服务下面有属性property、事件event和动作action。ha_xiaomi_home 内置的转换引擎会根据这些定义自动为设备生成合适的实体类型核心实现在custom_components/xiaomi_home/miot/specs/specv2entity.py这个文件里。转换规则很有逻辑性举几个最常见的MIoT-Spec-V2 定义转换成的 Home Assistant 实体可写的布尔属性开关 Switch只读的数值/状态属性传感器 Sensor可写且带枚举值的属性下拉选择 Select可写且带数值范围的属性数字调节 Number可写的文本属性文本 Text事件事件实体 Event无参数的动作按钮 Button带参数的动作通知实体 Notify也就是说一台智能灯接入后它的亮度、色温会自动变成可调节的数字实体开关状态变成 Switch你几乎不用做任何手动映射。另外如果某个设备的规格不是小米标准命名空间定义的实体名前面会自动加一个*号方便你一眼识别来源。组件还贴心地内置了13种语言包存放在custom_components/xiaomi_home/translations/目录下包括简体中文、繁体中文、英语、日语、德语、法语、西班牙语等界面语言会跟随 Home Assistant 自动适配。装上之后生活真的不一样了设备导入只是开始真正的乐趣在于自动化。这里分享几个我实际在用的场景都基于 ha_xiaomi_home 导入的设备回家亮灯门磁传感器检测到开门玄关灯立刻亮起本地模式响应几乎无延迟再根据时间判断是否打开客厅主灯。自动除湿湿度传感器超过70%加湿器自动开启低于55%自动关闭。️观影模式一句看电影客厅主灯关闭、氛围灯调成暖色、电视和音响开机。离家兜底检测到所有人离开自动关灯、关空调、启动扫地机器人。你可能注意到这些场景里既有小米设备也有其他品牌的设备——这正是接入 Home Assistant 的意义自动化不再被品牌圈在各自的App里。ha_xiaomi_home 负责把小米设备翻译给整个生态剩下的联动交给你的想象力。入坑前必看这些限制和坑官方没写进宣传里任何工具都有边界把话说在前面能帮你省不少排查时间三类设备暂不支持蓝牙设备、红外设备、虚拟设备。如果你家里主要是这类设备需要提前心理预期。中枢网关只在部分区域有售本地控制依赖小米中枢网关或内置中枢网关功能的设备而中枢网关目前仅在中国大陆发售。其他区域的用户默认走云端模式。LAN 控制功能要慎用如果家里没有中枢网关你可以在配置里开启局域网控制但要注意它只能控制 WiFi 或网线连接的 IP 设备控制不了 BLE Mesh、ZigBee 设备而且官方明确提示该功能可能引起异常不建议开启。另外一旦局域网内存在中枢网关LAN 控制会自动失效。相关参数可在custom_components/xiaomi_home/miot/lan/profile_models.yaml中查看。配置文件里会明文保存账号信息登录采用 OAuth 2.0不会存储密码但受 Home Assistant 平台限制设备信息、证书、token 等会明文保存在配置文件中。请务必保管好配置文件如果怀疑 token 泄露可以在米家App的账号管理里撤销对Home Assistant Integration的授权。云端模式依赖外网外网中断时云端控制会失效设备状态也可能延迟。追求稳定低延迟建议配一台中枢网关走本地模式。你可能想问的五个问题Q1支持所有小米设备吗绝大多数主流品类都支持只有蓝牙、红外和虚拟设备三类不行。Q2家里已经有一堆米家设备需要重新买吗不需要账号下的存量设备直接导入一台都不用重买。Q3可以同时用多个小米账号吗可以而且不同账号、甚至不同区域的设备都能合并到同一个 Home Assistant 里管理。Q4和米家App冲突吗不冲突米家App照常用Home Assistant 只是新增了一条管理通路。Q5我是新手配置难吗整个流程只有安装、登录、选家庭三步没有yaml要写配置难度对新手非常友好。最后从拥有设备到拥有场景回想一下当初买智能家居时我们想要的是什么不是一堆会单机联网的灯和插座而是回家灯亮、起床窗帘开、出门全屋安防这种整体体验。可现实中设备越多App越多体验反而越割裂。ha_xiaomi_home 的意义正是把这种割裂重新缝合起来——它让小米设备真正成为开放智能家居生态的一部分而不是被困在自家App里的孤岛。真正的智能家居从来不是比谁设备多而是比设备能不能协同。而这正是 ha_xiaomi_home 帮你实现的事。现在就去克隆一份试试吧五分钟之后你可能会和我一样再也回不去那个满屏App的日子了。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考