3步接入米家用 Xiaomi Home Integration 搭出下班回家自动化【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home钥匙插进锁孔玄关灯自动亮起五分钟后空调已调到 24℃——这就是本文要帮你搭出来的场景。借助 Home Assistant 的米家集成Xiaomi Home Integration你可以把手机定位、门锁、灯光、空调串成一条下班回家自动化从接入设备到指令路由逐步讲清。动手前的一键核对清单先把环境和组件状态过一遍。对照下表逐项打勾全部通过再往下走核对项通过标准Home Assistant Core 版本≥ 2024.4.4Home Assistant Operating System≥ 13.0米家集成是否已安装config/custom_components目录下存在xiaomi_home文件夹小米账号已登录且能正常浏览米家家庭设备位置设备与 Home Assistant 在同一局域网走本地通道时必需两种安装方式任选其一。下面这段命令把仓库拉到config目录并执行安装脚本完成后重启 Home Assistantcd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config./install.sh /config把xiaomi_home组件复制到custom_components下安装脚本详见 install.sh。日后想锁定版本git checkout v1.0.0切 tag 再跑一遍脚本即可。如果你更习惯图形界面就在 HACS 里搜索Xiaomi Home进入详情页点 DOWNLOAD 一键安装。装好后路径是设置 设备与服务 添加集成 搜索Xiaomi Home用小米账号登录并勾选要导入的家庭。设备随即以实体形式出现在你的系统里。指令怎么走云端与本地通道选型对比你发出的每一条指令要么走小米云要么走局域网直达设备。先说清 MQTT 是什么一个消息订阅-推送服务设备状态一变就主动通知集成不用反复轮询。维度云端控制本地控制原理向小米云 MQTT Broker 订阅状态指令经小米云 HTTP 接口下发经小米中枢网关内建 MQTT Broker 收发局域网直达设备响应速度取决于外网往返局域网内直达更快更稳硬件要求无小米中枢网关固件 ≥ 3.3.0_0023或内置中枢的设备协议限制基本支持全部品类蓝牙、红外、虚拟设备除外仅 IP 设备WiFi / 网线蓝牙 Mesh、ZigBee 设备仍走云端适用人群没有中枢网关、设备跨网络有中枢网关、追求低延迟开启方式设置 设备与服务 已配置 Xiaomi Home 配置 更新局域网控制配置。另外只要局域网里存在中枢网关即便你开了局域网控制集成也会优先走中枢通道无需手动二选一。选型一句话有中枢网关就用本地没有就用云端——两者都能完整支撑本文的自动化差别只在响应快慢。三步流水线触发、过滤、动作可导入示例任何一条 Home Assistant 自动化都是三段流水线trigger触发器定义什么时候开始例如手机进入家庭地理围栏。condition条件负责拦截只有条件全部满足才放行执行例如限制在 17:00 之后。action动作按顺序逐个下发设备指令。末尾的mode决定重复触发时的行为——设为single后场景正在执行时新的触发会被直接忽略避免空调被反复下发指令。下面这份 YAML 可直接粘贴进设置 自动化 新建 高级导入演示手机到家后依次开玄关灯、调空调、开主灯、启净化器alias: 下班回家自动化 trigger: - platform: device device_id: 你的手机设备ID domain: device_tracker type: enters zone: home condition: - condition: time after: 17:00 before: 23:00 action: - service: switch.turn_on target: entity_id: switch.玄关灯 - service: climate.set_temperature target: entity_id: climate.客厅空调 data: temperature: 24 - service: light.turn_on target: entity_id: - light.客厅主灯 - light.厨房灯 - service: fan.turn_on target: entity_id: fan.空气净化器 mode: singleplatform: devicetype: enters手机设备轨迹进入home地理围栏的那一刻触发。condition: time把场景限制在 17:00–23:00 之间白天路过门口不会误触发。mode: single同一时间只允许一个实例在跑。写之前先搞清米家设备 → HA 实体的映射规则。集成按 MIoT-Spec-V2小米 IoT 平台给设备写的标准化功能说明书自动转换核心规则如下设备/属性特征转换出的实体可写的布尔属性灯的开关Switch可写、无取值范围但有取值列表的属性如风速档位Select可写、有取值范围的属性如亮度Number只读属性温湿度计的读数Sensor带温度控制功能的设备空调、风扇类温控Climate无参数的 Action扫地机的开始清扫Button实体 ID 在设置 开发者工具 状态里按设备名搜索即可查到自动化里照抄即可。进阶玩法延迟、天气分支与多账号共享三个选做的增强按需取用。动作之间加延迟。部分设备尤其经云端下发时需要几秒响应动作间插入delay可以避免指令打架。下面片段让空调在玄关灯开启 5 秒后再调温action: - service: switch.turn_on target: entity_id: switch.玄关灯 - delay: seconds: 5 - service: climate.set_temperature target: entity_id: climate.客厅空调 data: temperature: 24delay只暂停后续动作不阻塞整条自动化的其他实例。按天气自动选模式。用choose分支让空调自己看天吃饭室外温度高于 28℃ 就制冷 24℃低于 15℃ 就制热 22℃。action: - choose: - conditions: - condition: numeric_state entity_id: sensor.室外温度 above: 28 sequence: - service: climate.set_temperature target: entity_id: climate.客厅空调 data: temperature: 24 hvac_mode: cool - conditions: - condition: numeric_state entity_id: sensor.室外温度 below: 15 sequence: - service: climate.set_temperature target: entity_id: climate.客厅空调 data: temperature: 22 hvac_mode: heatchoose按顺序匹配只执行第一个命中的分支所以把温度区间写清楚、互不重叠。多账号设备共享。家人各用各的小米账号在集成页面点添加中枢再用第二个账号登录勾选要导入的设备即可。不同账号的设备可以放进同一个区域统一管理你的自动化因此能覆盖全屋设备。排障速查表三列定位问题现象可能原因处理动作设备无响应设备离线 / 本地通道覆盖不到该协议设备 / 云端接口异常在集成页面确认设备在线蓝牙 Mesh、ZigBee 设备只能走云端勿依赖本地控制重启设备后重载集成自动化不触发地理围栏未生效、时间条件不满足、device_id写错到开发者工具 状态核对设备轨迹实体当前值临时移除condition再测区分是触发问题还是过滤问题状态不同步设备上报延迟、实体转换规则过期开启配置 Action 调试模式手动发一条指令验证设备可达改过实体转换规则后记得在配置页点更新实体转换规则完整问题反馈与反馈渠道见 贡献指南版本演进见 更新日志。收尾下一步可以试试把离家场景做成镜像自动化、给老人配一条一键全关的 Button、再结合天气分支让新风和空调联动。更多规则细节可回看 官方中文文档装好后记得对照 更新日志 跟进新版本。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考