將 WiiM 裝置整合至 Home Assistant 的完整指南：打造智慧音訊自動化

發佈日期： | 文章分類：智慧家庭教學

Home Assistant (HA) 是目前最強大的開源智慧家庭自動化平台，能讓您在一台裝置上集中管理各種不同品牌的智慧家電。

 

好消息是，WiiM 裝置已獲得 Home Assistant 的官方正式支援！透過這次的官方整合，不論您使用的是 WiiM Pro、WiiM Pro Plus 還是 WiiM Amp，都能輕鬆串接至 HA 系統，享受直覺的音樂播放控制，甚至能將串流音樂融入您的智慧家庭自動化情境中。

💡 系統相容性備忘： 本次 WiiM 官方整合功能需配合 Home Assistant 版本 2026.4 或更新版本。在開始前請先確認您的系統已完成升級。

💡 注意： Home Assistant整合需要WIIM的機型有支援Google Chromecast 的功能WiiM MINI不支援Google Chromecast 故無法使用。

本文目錄

  • 一、如何將 WiiM 裝置新增至 Home Assistant
  • 二、WiiM 播放控制與功能介面
  • 三、維持 WiiM 與 HA 流暢連線的實用小技巧

一、如何將 WiiM 裝置新增至 Home Assistant

1. 事前準備檢查清單

  • 確保已安裝並運行 Home Assistant 2026.4 或以上版本（詳細請參考 HA 官方安裝指南）。
  • 確認您的 WiiM 裝置已下載 WiiM Home App 並完成了初始網路設定。
  • 關鍵步驟：確保運行 Home Assistant 的主機與您的 WiiM 裝置連接在同一個區域網路（網域）中。

  • 建議將 WiiM 裝置更新至最新版韌體，以發揮最佳的相容性。

     

2. 方法 A：快速自動整合（推薦）

這是最快速的序列串接方式：

  1. 使用瀏覽器開啟 Home Assistant WiiM 官方整合網頁。
  2. 點擊頁面上的「My Home Assistant」圖示，系統將會引導並自動開啟您家中的 HA 控制台。

  3. Home Assistant 將會透過網域自動偵測（Auto-Discover）您的 WiiM 串流播放器，並在畫面上顯示為「已偵測到 (Discovered)」，點擊同意即可完成綁定。

     

3. 方法 B：手動手動設定步驟

若您的網路環境未觸發自動偵測，請嘗試以下手動新增步驟：

  1. 開啟電腦瀏覽器，登入您的主控台（預設通常為：http://homeassistant.local:8123/），亦可使用手機 HA App。

  2. 在左側側邊欄點選「設定 (Settings)」 > 「裝置與服務 (Devices & Services)」。

  3. 如果畫面上未出現已偵測裝置，請點選右下角的「新增整合 (Add Integration)」，並搜尋 WiiM。
  4. WiiM 設備指派到特定的房間（例如：客廳、主臥室）

    點擊新增後，您可以將該 WiiM 設備指派到特定的房間（例如：客廳、主臥室）。

     

成功新增後，您就可以在 HA 的「概覽 (Overview)」儀表板中看見您的 WiiM 媒體播放器（Media Player）小卡了！

在 HA 的「概覽 (Overview)」儀表板

 

二、WiiM 播放控制與功能介面

當整合成功後，只要您透過手機或 WiiM 裝置開始播放音樂，Home Assistant 的儀表板上就會即時同步彈出「正在播放 (Now Playing)」控制列。

 

進階調整播放

 

如果您想進行進一步的精細調整，可以點擊該控制卡片右上角的 三點圖示 (⋮)，這將會開啟完整的媒體播放器控制面板：

 

支援控制功能功能說明
基礎播放控制支援播放、暫停、上一首、下一首切換。
音量調節可直接滑動調整音量大小，或切換靜音。
播放模式切換支援開啟/關閉「隨機播放 (Shuffle)」與「重複播放 (Repeat)」。
輸入源選擇 (Source)可一鍵切換 Wi-Fi 串流、藍牙 (Bluetooth)、光纖 (Optical) 或 Line-In 輸入。
預設與隊列點擊對應圖示可讀取您的 WiiM 預設快捷鍵 (Presets) 並瀏覽待播放清單。

#playback-control

自動化設定播放

三、維持 WiiM 與 HA 流暢連線的實用小技巧

為了讓您的智慧音響自動化情境（例如：早上 7:00 預時自動用 WiiM 播放音樂）百分之百成功運行，請注意以下幾點：

  • 穩定的網路架構： WiiM 與 HA 之間的通訊高度依賴本地網路。如果可能的話，建議將主機與 WiiM 裝置（如 WiiM Pro/Amp）透過有線網路（Ethernet）連接，或是確保 Wi-Fi 訊號在 -60 dBm 以上。
  • 固定 IP 設定： 建議在您的路由器（Router）中，為 WiiM 裝置設定「靜態 IP（DHCP 伺服器預留）」，避免裝置因重新開機變更 IP 導致 HA 暫時斷線。
  • 保持系統同步更新： 定期檢查 Home Assistant 的核心更新以及 WiiM App 的韌體提示，官方更新通常包含重要的穩定性修正。

  • 遇到問題時的除錯： 若發現裝置離線，可先嘗試重新啟動路由器與 WiiM 裝置。若仍有問題，可尋求智慧家庭專業安裝師協助，或前往 WiiM 官方論壇回報。