米家集成接入 Home Assistant搭好下班回家自动场景的 4 个关键步骤【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home晚上推开门摸黑找灯、手动开空调、再挨个启动净化器——这一串动作每天都在重复。把这套流程交给 Home Assistant 自动完成正是 Xiaomi Home米家集成要解决的问题。这篇文章按检查清单、控制方式取舍、自动化配置、排障四个环节把下班回家场景一步步搭起来。安装前检查清单版本要求与三种安装方式先核对版本Home AssistantCore ≥ 2024.4.4Operating System ≥ 13.0低于这两个版本集成无法加载。安装有三条路挑顺手的Git 克隆官方推荐在config目录执行git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home进入目录后运行 install.sh。好处是日后git fetch切换 Tag 就能回滚到任意版本HACS 安装打开 HACS 搜索Xiaomi Home进详情页点 DOWNLOAD不用碰命令行手动复制把custom_components/xiaomi_home整个文件夹放进config/custom_components装完走登录流程进入设置 设备与服务 添加集成搜Xiaomi Home用小米账号授权然后在选择家庭与设备里勾选家庭设备即全部导入。家人用的是不同小米账号的话可以在集成页面添加中枢再登一个设备能并入同一个区域后续自动化里统一调用。云端还是本地控制一张对比表做取舍指令从哪条路下发、状态从哪条路回来是这两种通道的根本区别对比项云端控制本地控制前提条件无登录后默认就是它需小米中枢网关固件 3.3.0_0023 及以上或内置中枢网关的设备软件 0.8.9 及以上且仅中国大陆可用指令下发经小米云 HTTP 接口经网关内 MQTT Broker 转发状态更新订阅小米云 MQTT 推送订阅中枢网关 MQTT 推送覆盖范围几乎所有受支持设备网关管辖的设备哪种更适合你没有中枢网关就放心用云端默认配置已覆盖绝大多数设备家里正好有网关、设备又以 WiFi 或网线接入为主时本地通道不依赖外网响应更快。还有个小米局域网控制选项设置 设备与服务 已配置 Xiaomi Home 配置 更新局域网控制配置它只能控制同一局域网内的 IP 设备蓝牙 Mesh、ZigBee 设备管不到官方文档不建议开启局域网里已有中枢网关时该选项也不会生效。动手搭建回家场景认实体、配自动化、做验证第一步认实体。集成按 MIoT-Spec-V2 协议把设备翻译成实体可写的 bool 属性转成Switch带取值列表的可写属性转成Select带取值范围的转成Number只读属性转成Sensor无输入参数的方法转成Button。所以一盏可调光的灯你会拿到一个开关实体加一个亮度Number实体完整映射规则见 specv2entity.py。第二步配自动化。下面这段覆盖典型流程手机进家触发、限定时间窗口然后开灯、调空调、启动净化器。把实体 ID 换成你家的存进config/automations.yaml即可。alias: 下班回家自动场景 trigger: - platform: zone zone: home entity_id: device_tracker.your_phone event: enter condition: - condition: time after: 17:30 before: 23:00 action: - service: light.turn_on target: entity_id: - light.entry_light - light.living_room_light - service: climate.set_temperature target: entity_id: climate.living_room_ac data: temperature: 24 - service: fan.turn_on target: entity_id: fan.air_purifier mode: single第三步验证。先在自动化详情页点运行手动执行一遍动作确认每个实体都响应触发器不放心时把手机的位置临时切到 home 区域看整条链路是否按预期走通。自动化不工作症状与排查动作速查跑不起来时问题大多落在这三类里从上往下查症状排查动作设备无响应在集成页面确认设备是否在线重启集成或设备本地控制时确认网关与设备处于同一网段自动化不触发核对触发条件位置、时间窗口是否满足到设置 开发者工具 状态里确认实体 ID 没写错状态不同步经设置 设备与服务 已配置 Xiaomi Home 配置 Action 调试模式开启后手动下发指令测试并对照米家 App 里的实际状态都排完仍有问题翻一下config/home-assistant.log日志等级临时调到 debug能看到集成加载和消息收发的更多细节。场景搭完之后三个可以继续玩的方向跟天气联动给自动化加一个基于室外温度的numeric_state条件室外偏热时自动调制冷、偏冷时改制热同一套触发器四季通用多账号设备统一编排把家庭成员各自的米家设备并入同一区域后可以用任一家人的门锁事件或位置变化触发同一个回家场景界面本地化集成支持 13 种语言设备名的翻译可以在custom_components/xiaomi_home/miot/i18n/里补充改完后到配置 更新实体转换规则生效回家场景只是起点语音控制、安防联动都能挂进这条自动化链。更多细节看 中文文档功能变动看 更新日志想提改进建议或反馈问题参考 贡献指南 参与项目即可。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考