小米智能家居终极集成指南：从快速入门到高级定制开发

【免费下载链接】ha_xiaomi_home Xiaomi Home Integration for Home Assistant 项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

ha_xiaomi_home是一款专为Home Assistant设计的小米智能家居集成插件，它能够帮助用户轻松实现小米智能设备与Home Assistant的无缝连接与控制。通过该插件，用户可以在Home Assistant平台上统一管理和操作各类小米智能家居设备，打造个性化的智能生活体验。

安装小米智能家居集成插件的三种简单方法

安装ha_xiaomi_home插件有多种便捷方式可供选择，以下为你详细介绍：

方法一：通过HACS一键安装（推荐）

我们推荐使用此方法安装米家集成。当您想要更新至特定版本时，只需要切换至相应的Tag 。一键从 HACS 安装米家集成，简单方便，适合大多数用户。

方法二：通过Git克隆仓库安装

如果您熟悉Git操作，可以通过以下命令克隆仓库进行安装：

git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

方法三：通过Samba或FTPS手动安装

您还可以通过Samba或FTPS手动安装插件。

轻松配置小米智能家居集成

安装完成后，就可以进行配置操作了。

首次配置步骤

用一个小米账号登录并配置完成后，您可以在 Xiaomi Home Integration 页面中继续添加其他小米账号。方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 添加中枢 > 下一步 > 请点击此处进行登录 > 使用小米账号登录。

修改配置项

在会话框“配置选项”中，可选择需要变更的配置项。您可以修改用户昵称或更新从米家 APP 导入的设备列表。方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 选择需要变更的配置项。

小米智能家居集成的两种控制方式

ha_xiaomi_home提供了云端控制和局域网控制两种方式，满足不同用户的需求。

云端控制方式

小米智能家居集成通过云服务实现对设备的控制。米家集成所用的云服务接口已部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国共六个地区的机房。由于用户数据在不同地区的小米云上相互隔离，您需要在配置 Home Assistant 时选择用户所在地区，才能导入相应的米家设备。

米家集成向小米云 MQTT Broker 订阅关注的设备消息。当设备属性发生改变或产生设备事件时，设备向小米云发送上行消息， MQTT Broker 向米家集成推送订阅的设备消息。由于米家集成不需要向云端轮询以获取设备当前的属性值，因此米家集成能第一时间获知设备属性变化或事件发生。得益于消息订阅机制，米家集成只在配置完成时向云端查询一次所有的设备属性，对云端产生的访问压力很小。

局域网控制方式

米家集成也能通过开启小米局域网控制功能实现部分本地化控制效果。小米局域网控制功能只能控制与 Home Assistant 处于同一局域网内的 IP 设备（使用 WiFi、网线连接路由器的设备），无法控制蓝牙 Mesh、ZigBee 等协议接入的设备。

该功能可能会引起一些异常，我们建议不要使用该功能。小米局域网控制功能开启方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 更新局域网控制配置。

丰富的实体类型支持

ha_xiaomi_home支持多种实体类型，能够满足不同智能设备的控制需求，相关的实现代码位于custom_components/xiaomi_home/目录下，包括：

• binary_sensor.py
• button.py
• climate.py
• cover.py
• device_tracker.py
• event.py
• fan.py
• humidifier.py
• light.py
• media_player.py
• notify.py
• number.py
• select.py
• sensor.py
• switch.py
• text.py
• vacuum.py
• water_heater.py

多语言支持与个性化定制

米家集成配置选项中可选择的集成使用的语言有简体中文、繁体中文、英文、西班牙语、俄语、法语、德语、日语、意大利语、荷兰语、葡萄牙语、巴西葡萄牙语、土耳其语这十三种语言。目前，米家集成配置页面的简体中文和英文已经过人工校审，其他语言由机器翻译或社区贡献。

如果您希望修改配置页面的词句，则需要修改custom_components/xiaomi_home/translations/以及custom_components/xiaomi_home/miot/i18n/目录下相应语言的 json 文件。

在显示 Home Assistant 实体名称时，米家集成会从小米云下载设备厂商为设备配置的多语言文件，该文件包含设备 MIoT-Spec-V2 实例的多语言翻译。multi_lang.json是本地维护的多语言配置字典，其优先级高于从云端获取的多语言文件，可用于补充或修改设备的多语言翻译。

在 Home Assistant 中修改了custom_components/xiaomi_home/miot/specs路径下的任何文件（spec_filter.yaml、spec_modify.yaml、multi_lang.json等），需要在集成配置中更新实体转换规则才能生效。方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 更新实体转换规则

【免费下载链接】ha_xiaomi_home Xiaomi Home Integration for Home Assistant 项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home