本指南将详细介绍如何在Home Assistant中配置和使用Xiaomi Home集成，帮助您快速接入小米智能家居设备。
项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home 环境准备与系统要求
在开始配置前，请确保您的Home Assistant满足以下最低版本要求：
- Core版本 ≥ 2024.4.4
- 操作系统版本 ≥ 13.0
安装方法详解
Git克隆安装（推荐）
这是最推荐的安装方式，便于后续版本管理和更新：
cd config
git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config
升级到特定版本的操作示例：
cd config/ha_xiaomi_home
git fetch
git checkout v1.0.0
./install.sh /config
手动安装方式
对于使用Samba或FTPS的用户，可以手动将custom_components/xiaomi_home文件夹复制到Home Assistant配置目录的config/custom_components文件夹中。
配置流程实战步骤
第一步：账号登录配置
- 进入Home Assistant设置界面
- 选择"设备与服务"部分
- 点击"添加集成"
- 搜索"Xiaomi Home"
- 点击"下一步"
- 点击"点击这里登录"
- 使用小米账号完成授权登录
第二步：设备选择与导入
成功登录后，系统将弹出"选择家庭和设备"对话框。您需要选择包含要导入设备的小米家庭。
第三步：多账号配置
如果需要添加多个小米账号，可以在已配置的Xiaomi Home集成页面继续添加：
- 设置 > 设备与服务 > 已配置 > Xiaomi Home
- 点击"添加集线器"
- 点击"下一步"
- 点击"点击这里登录"
- 使用其他小米账号完成授权
高级功能配置技巧
本地控制配置
Xiaomi Home集成支持通过小米中枢网关实现本地控制功能。本地控制架构如下：
调试模式启用
启用动作调试模式后，您可以手动向设备发送带有参数的Action命令消息。发送Action命令的用户界面将以Text实体的形式显示。
启用方法：
- 设置 > 设备与服务 > 已配置 > Xiaomi Home
- 点击"配置"
- 选择"动作调试模式"
安全注意事项
Xiaomi Home集成使用OAuth 2.0登录流程，不会在Home Assistant应用中保存您的账号密码。但请注意，成功登录后，您的小米账号用户信息（包括设备信息、证书、令牌等）将以明文形式保存在Home Assistant配置文件中。
如果怀疑OAuth 2.0令牌泄露，可通过以下步骤撤销登录授权：
- 打开小米Home APP
- 进入个人资料页面
- 点击用户名进入小米账号管理页面
- 基础信息：应用
- Xiaomi Home (Home Assistant集成)
- 点击"移除"
常见问题解决方案
设备支持范围问题
问：Xiaomi Home集成支持所有小米智能设备吗？
答：目前支持大多数智能设备类别，仅少数类别不支持，包括蓝牙设备、红外设备和虚拟设备。
区域限制问题
问：Xiaomi Home集成在哪些区域可用？
答：集成可在国内、欧洲、印度、俄罗斯、新加坡和美国使用。由于不同区域的用户数据是隔离的，在配置过程中导入MIoT设备时需要选择您的区域。
核心组件说明
项目的核心代码位于custom_components/xiaomi_home/miot/目录下：
- miot_client：集成中添加登录用户时需要添加miot_client实例
- miot_cloud：包含云服务相关功能，包括OAuth登录流程、HTTP接口功能等
- miot_device：设备实体，包含设备信息、属性、事件和动作的处理逻辑
- miot_mips：订阅和发布方法的消息总线
- miot_spec：解析MIoT-Spec-V2协议
多语言支持配置
Xiaomi Home集成支持13种语言选择，包括简体中文、繁体中文、英文、西班牙文、俄文、法文、德文、日文、意大利文、荷兰文、葡萄牙文、巴西葡萄牙文和土耳其文。
如需修改配置流程页面中的文字和句子，需要修改custom_components/xiaomi_home/translations/和custom_components/xiaomi_home/miot/i18n/目录中特定语言的json文件。
通过本指南的步骤，您应该能够顺利完成Xiaomi Home集成的安装和配置，享受小米智能设备在Home Assistant中的便捷控制体验。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
