小米開源「Home Assistant米家集成」，讓用戶更“開放”地使用小米IoT智能設備
小米在GitHub上正式開源了「Home Assistant 米家集成」（Xiaomi Home Integration）項目。這是一個由小米官方提供支持的Home Assistant集成組件，旨在讓用戶能夠在Home Assistant平臺中無縫使用小米IoT智能設備。
一、項目背景與介紹
Home Assistant是一個基于Python 3開發的開源家庭自動化平臺，它能夠跟蹤和控制家庭中的所有設備，并實現自動化控制。小米此次開源的米家集成項目，正是為了讓更多用戶能夠享受到更加開放和便捷的智能設備使用體驗。
二、項目特點
官方支持：米家集成及其使用的云端接口均由小米官方提供，確保了項目的穩定性和可靠性。OAuth 2.0登錄：用戶需要使用小米賬號登錄以獲取設備列表，但米家集成不會在Home Assistant中保存用戶的小米賬號密碼，而是通過OAuth 2.0的登錄方式保障用戶信息安全。消息訂閱機制：米家集成向小米云MQTT Broker訂閱關注的設備消息，當設備屬性發生改變或產生設備事件時，能夠第一時間獲知并作出響應。三、消息收發原理
云端控制
米家集成向小米云MQTT Broker訂閱設備消息。
設備屬性變化或事件發生時，設備向小米云發送上行消息，MQTT Broker向米家集成推送訂閱的設備消息。
米家集成需要控制設備時，通過小米云HTTP接口向設備發送控制消息。
本地控制
小米中樞網關內包含標準的MQTT Broker，實現訂閱發布機制。
米家集成向小米中樞網關訂閱設備消息。
設備屬性變化或事件發生時，設備向小米中樞網關發送上行消息，MQTT Broker向米家集成推送訂閱的設備消息。
米家集成需要控制設備時，向MQTT Broker發布設備控制消息，再經由小米中樞網關轉發給設備。
四、使用要求與限制
Home Assistant版本要求：Core ≥ 2024.11.0，Operating System ≥ 13.0。米家集成目前支持大部分米家設備品類，但仍有小部分設備品類（藍牙、紅外及虛擬設備）不支持。米家集成支持多個小米賬號同時登錄，并支持不同賬號的米家設備添加至同一個Home Assistant區域。米家集成支持通過小米中樞網關或內置中樞網關的米家設備實現本地化控制，但如果沒有這些設備，則所有控制指令都會通過小米云發送。小米中樞網關僅在中國大陸可用。米家集成也能通過開啟小米局域網控制功能實現部分本地化控制效果，但可能會引起一些異常，建議謹慎使用。五、地區與云服務
米家集成所用的云服務接口已部署在中國大陸、歐洲、印度、俄羅斯、新加坡、美國共六個地區的機房。用戶需要在配置Home Assistant時選擇用戶所在地區，才能導入相應的米家設備。米家集成支持將不同地區的米家設備添加至同一個Home Assistant區域。六、安裝方法
用戶可以通過訪問GitHub上的項目頁面，按照提供的安裝指南進行Home Assistant米家集成的安裝和配置。具體安裝方法請參考項目頁面中的README文檔。
七、總結
小米此次開源「Home Assistant米家集成」項目，不僅展示了其對開放生態的承諾，也為廣大用戶提供了更加靈活和便捷的智能設備使用體驗。通過這一項目，用戶能夠更加自由地管理和控制自己的小米IoT智能設備，享受智能家居帶來的便利和樂趣。