小米近日在 GitHub 正式开源了 HA (Home Assistant) 的米家官方集成 (Integration)，为 HA 高阶玩家用户带来更安全、更稳定的设备控制与管理方案。
![]()
开源地址：https://github.com/XiaoMi/ha_xiaomi_home
HA 米家官方集成一经推出，就吸引了大批极客用户下载使用。短短两天，GitHub Star 数量已经超 1 万 。
作为全球最大的本地智能家居开源软件平台，HA 能够支持多种品牌家居设备的管理和控制。
通过安装集成 (Integration)，用户可以轻松实现家居设备的自动化场景创建，并通过 “Add-ons” 商店拓展三方开发的插件能力，如 SSH、Samba、Node-RED 等。
作为一个典型的极客工具，HA 米家官方集成在具备“高可玩性”的同时也有着不低的技术门槛，是为资深玩家打造的智能家居领域利器，建议资深玩家深度体验，共同发掘其创新潜能。
对于普通用户也可勇敢尝试，不过鉴于其技术复杂性，可将其视作学习成长的契机，需要有足够的心理预期。
作为全球最大的本地智能家居开源软件平台，HA能够支持多种品牌家居设备的管理和控制。通过安装集成 (Integration)，用户可以轻松实现家居设备的自动化场景创建，并通过“Add-ons”商店拓展三方开发的插件能力，如 SSH、Samba、Node-RED 等。
目前，HA Integrations 已超过 2900 个，小米设备在社区中也因大量个人开发者的贡献而高度活跃。
1/ HA米家官方集成的主要优势
*注意：目前HA 米家官方集成严格限制仅可用于非商业用途（详见文末License声明）。
与现有的第三方米家设备集成相比，HA米家官方集成在安全和稳定性方面表现出色。它提供了官方的 OAuth 2.0 登录方式，账号密码不需提供给第三方，避免了账号密码泄露的风险。同时，该集成支持多账号登录，能够同时管理数千个设备。
HA米家官方集成还提供了全球多个地区的账号登录服务，目前已覆盖中国大陆、欧洲、印度、俄罗斯、新加坡、美国共六个地区。通过米家 IoT 云服务提供的独立 Home Assistant 接口和域名，让集成连接更稳定，同时不影响米家客户端用户的正常使用。在设备使用体验方面，HA米家官方集成采用 MQTT 方式与云服务连接，能够更友好地订阅设备状态变化和相关事件，设备状态更新的时效性显著提升。此外，它还支持自动将小米 IoT 设备模型转换成 Home Assistant 平台的设备模型，提供更全面的设备能力，并支持多语言自动翻译，满足不同地区用户的需求。人在传感器小米Spec 转 HA 实体、插座中文实体、插座英文实体HA米家官方集成不仅支持云端控制，还实现了本地控制功能。它能根据云端和本地的链路情况自动选择和切换，确保用户在不同网络环境下都能顺畅控制家居设备。未来小米中枢设备都会升级支持（当前版本测试中）Home Assistant的本地控制功能。目前，小米中枢网关、小米路由器 BE6500 Pro、小米全屋路由 BE3600 Pro 套装等设备已支持中枢能力，未来小米还将增加更多支持中枢的设备，进一步提升用户的智能家居体验。![]()
2/ 使用注意事项与许可证声明
此次发布，用户需遵守许可证规定，仅限于为非商业性目的使用 Home Assistant 而复制、使用、修改、分发授权作品。任何超出许可证规定范围的行为，包括但不限于开发应用程序、Web 服务以及其他形式的软件等，均被视为侵权行为。小米保留对授权作品的所有权及知识产权，并有权在特定情况下终止对用户的授权。
许可 （C） 2024 小米
在本许可证下提供的HA米家官方集成（Xiaomi Home Integration）和相关米家云服务 API 接口，包括源代码和目标代码（统称为“授权作品”）的所有权及知识产权归小米所有。小米在此授予您一项个人的、有限的、非排他的、不可转让的、不可转授权的、免费的权利，仅限于您为非商业性目的使用 Home Assistant 而复制、使用、修改、分发授权作品。为避免疑义，本许可证未授权您将授权作品用于任何其他用途，包括但不限于开发应用程序（APP）、Web 服务以及其他形式的软件等。您在重新分发授权作品时，无论修改与否，无论以源码形式或目标代码形式，您均需保留本授权作品中的版权标识、免责声明及本许可证的副本。授权作品是按“现状”分发的，小米不对授权作品承担任何明示或暗示的保证或担保，包括但不限于对授权作品没有错误或疏漏、持续性、可靠性、适用于某一特定用途或不侵权等的保证、声明或承诺。在任何情况下，对于因使用授权作品或无法使用授权作品而引起的任何直接、间接、特殊、偶然或后果性损害或损失，您需自行承担全部责任。本许可证中未明确授予的所有权利均予保留，除本许可证明确授予您的权利外，小米未以任何形式授权您使用小米及小米关联公司的商标、著作权或其他任何形式的知识产权，例如在未获得小米另行书面许可的情况下，您不得使用“小米”、“米家”等与小米相关的字样或其他会使得公众联想到小米的字样对您使用授权作品的软件或搭载授权作品的硬件做任何形式的宣传或推广。在下述情况下，小米有权立即终止对您依据本许可证获得的授权：您对小米或其关联公司的专利或其他知识产权提起专利无效、诉讼或其他主张；
您生产、制造（含委托制造）、销售（含委托销售）模仿或复制小米产品（包含小米关联公司的产品）的山寨产品。
法律声明 （C） 2024 小米
HA米家官方集成（Xiaomi Home Integration）所使用的米家云服务 API 接口（以下简称小米云接口）的所有权及其知识产权为小米所有。您仅限于在米家集成许可证规定的范围内使用，任何超出前述许可证规定范围外的行为，包括但不限于在非 Home Assistant 平台上使用小米云接口、以及基于商业目的在 Home Assistant 平台上使用小米云接口等行为均应被视为侵权行为，小米有权对您使用的小米云接口采取包括但不限于停止使用、删除、屏蔽、断开连接等措施，同时保留向您追究相关法律责任的权利。小米拥有本声明的最终解释权。最后，HA米家官方集成将不断优化和升级，为用户带来更加便捷、智能的家居生活体验。来源：https://mp.weixin.qq.com/s/AI_ylBxfcYKtOHDHm3O8cQ![]()
