無程式碼也能輕鬆打造專業LINE官方帳號！一鍵導入模板，讓AI助你行銷加分！
Home Assistant 已成為開源家庭自動化的業界標準，將來自數十家製造商的裝置統一到單一控制介面中。但與特定生態系統的整合歷來依賴於社群開發的外掛，這些外掛逆向工程通訊協定，並在製造商更新韌體時失效。Xiaomi Home（ha_xiaomi_home）徹底改變了這種動態：它是由小米自行開發和維護的官方 Home Assistant 整合套件。
這種官方支援意味著整合獲得小米工程團隊的直接支援、官方 API 的存取權限，以及與當前和未來小米 IoT 裝置的保證相容性。對於數百萬小米和米家智慧家庭使用者來說，這項整合橋接了小米平價且廣泛的裝置生態系統與 Home Assistant 強大的自動化引擎之間的鴻溝。
該整合支援兩種操作模式：透過區域網路的米家協議進行本地控制，以及透過小米伺服器的雲端控制。本地模式提供更低的延遲，即使在網際網路中斷時也能運作，而雲端模式則支援遠端存取和需要雲端中介的裝置。
Xiaomi Home 整合如何運作？
該整合透過多層架構將 Home Assistant 連接到小米 IoT 生態系統。
流程圖 TD
A[Home Assistant\n自動化引擎] --> B[ha_xiaomi_home\n整合層]
B --> C{裝置發現\nMi Home 協議}
C --> D[區域網路\n直接 UDP/ TCP]
C --> E[雲端 API\n小米伺服器]
D --> F[本地裝置\n掃地機 / 燈具 / 感測器]
E --> G[雲端裝置\n攝影機 / 部分開關]
F --> H[實體登錄\nHome Assistant 裝置]
G --> H
H --> I[自動化\nHA 腳本與場景]
H --> J[儀表板\nHA Lovelace UI]
H --> K[語音助理\nAlexa / Google Home]
在安裝過程中，整合會發現區域網路上的小米裝置，並透過小米的雲端 API 進行驗證。裝置隨後被註冊為 Home Assistant 實體，每個裝置的能力被映射到適當的 Home Assistant 領域（燈光、感測器、開關、掃地機器人等）。
支援哪些裝置以及有哪些功能？
該整合支援小米龐大 IoT 產品線的大部分裝置。
| 裝置類別 | 範例 | 支援功能 |
|---|---|---|
| 燈具 | 米家 LED 燈泡、吸頂燈、燈帶 | 開關、亮度、色溫、RGB |
| 感測器 | 人體感應、門窗、溫濕度、光照 | 狀態監控、電量 |
| 開關與插座 | 智慧插座、無線開關、牆壁開關 | 開關、功率監控、定時 |
| 掃地機器人 | 石頭、米家掃地機器人 | 啟動/停止、返回充電座、區域清掃 |
| 空氣清淨機 | 米家空氣清淨機 | 開關、風扇速度、濾網狀態 |
| 窗簾 | 米家智慧窗簾 | 開/關、位置百分比 |
| 氣候裝置 | 米家暖氣、風扇、除濕機 | 開關、模式、溫度設定 |
裝置支援透過整合更新持續擴展，且由於整合由官方維護，新小米產品的支援通常比社群替代方案更快。
安裝和配置選項有哪些？
整合可透過多種安裝路徑取得，以滿足不同使用者的偏好。
| 安裝方式 | 難度 | 更新機制 | 備註 |
|---|---|---|---|
| HACS | 簡單 | 透過 HACS 自動更新 | 推薦給大多數使用者 |
| 手動下載 | 中等 | 手動替換 | 適合沒有 HACS 的使用者 |
| Home Assistant 附加元件 | 簡單 | 自動 | 透過專用附加元件倉庫 |
配置需要一個小米帳號，並知道裝置註冊在哪個小米伺服器區域。整合支援中國、歐洲、印度、俄羅斯、新加坡和美國伺服器。在初始設定中，整合會根據網路特徵自動偵測伺服器區域，但使用者可以手動覆蓋。
官方整合相較於社群替代方案的優勢
在小米發布官方整合之前，Home Assistant 使用者依賴社群開發的元件，如 Xiaomi Gateway（Aqara）和 Xiaomi Miot。官方整合提供了以下幾個優勢。
| 面向 | 官方整合（ha_xiaomi_home） | 社群整合 |
|---|---|---|
| 維護 | 小米工程團隊 | 社群志願者 |
| API 存取 | 官方、有文件的 API | 逆向工程協議 |
| 裝置支援 | 保證支援當前小米裝置 | 取決於貢獻者興趣 |
| 更新延遲 | 新裝置發布後數天至數週 | 數週至數月 |
| 重大變更 | 與韌體更新協調 | 意外中斷 |
| 認證 | 標準小米帳號 | 可能需要裝置 Token |
對於在 Home Assistant 內承諾使用小米生態系統的使用者來說，官方整合提供了最可靠且面向未來的路徑。
常見問題
什麼是 Xiaomi Home（ha_xiaomi_home）？ Xiaomi Home 是由小米開發的官方 Home Assistant 整合套件，可讓使用者直接從 Home Assistant 平台控制小米和米家智慧家庭裝置，同時支援本地網路和雲端控制。
有哪些安裝方式？ 可透過 Home Assistant 社群商店（HACS）、手動複製自訂元件目錄，或直接從 GitHub 倉庫下載等方式安裝。
支援哪些小米裝置？ 該整合支援多種小米和米家智慧裝置，包括燈具、感測器、開關、插座、掃地機器人、空氣清淨機、窗簾等，並持續更新以增加新裝置支援。
整合支援區域伺服器嗎？ 是的，整合支援所有小米區域伺服器，包括中國、歐洲、印度、俄羅斯、新加坡和美國，安裝時會自動偵測伺服器區域。
本地控制和雲端控制有何不同？ 本地控制透過區域網路直接與小米裝置通訊，延遲更低且可在無網路時運作；雲端控制則透過小米伺服器路由命令，需要網際網路連線。
延伸閱讀
- ha_xiaomi_home GitHub 倉庫 – 官方原始碼和文件
- Home Assistant 官方網站 – 開源家庭自動化平台
- Home Assistant 社群商店（HACS） – 推薦的整合安裝方式
- 小米 IoT 平台 – 小米官方 IoT 開發者文件
