常見問題
本頁收集了在 GitHub 問題追蹤器 上經常出現的問題。在開啟新問題之前先檢查這裡可以節省時間，因為大多數這些並非錯誤，而是 documented 原因下的預期行為。
搜尋現有問題
都不是嗎？在開啟新的問題之前，請務必搜尋 GitHub 上已關閉的問題。如果問題仍然存在，問題回報 頁面說明了如何收集除錯日誌並開啟正確的錯誤回報或功能請求。
通知可以推送到手機嗎？
顯示答案
不能直接推送。預設情況下，整合僅在 Home Assistant 儀表板內創建 持久通知；它們 不會自動轉發到手機上的 Home Assistant Companion App，因為這需要特定的每個設備的通知目標，而整合中沒有該功能。
要在手機上接收它們， 自訂自動化 必須創建一個能夠監聽整合的 事件 （或生成的持久通知）並將它們轉發到 notify 行動裝置的目標。
障礙物 / AI 偵測照片未顯示 地圖支援
顯示答案
如果即使在應用程式中啟用了 AI 障礙物圖片上傳，障礙物圖片仍然為空，而連接到 Home Assistant 的帳戶是 共享/家庭帳戶 而非最初添加並擁有該設備的帳戶，製造商的雲端 API 可能會默默地阻止該共享帳戶訪問障礙物圖片。使用實際擁有的帳戶，或在應用程式中確認已明確授予共享帳戶相機訪問權限，大多數情況下可以解決此問題。
地圖相機可以串流到 HomeKit / Apple Home 嗎？ 地圖支援
顯示答案
作為即時影像並不可靠。地圖攝像頭以真正的 MJPEG 流方式傳輸，這與 Home Assistant 自身的攝像頭平台使用的方法相同，因此 Apple Home 中的靜態預覽圖像顯示正確。只有當地圖實際發生變化時才會生成新幀，而在吸塵器閒置時，這個流不會產生任何內容。HomeKit 的即時影像需要一個持續刷新的來源才能保持連接，而 Home Assistant 必須通過額外的一層將 MJPEG 流轉換後，HomeKit 才能顯示，因為 HomeKit 無法直接接受 MJPEG。當地圖流停止時，那個轉換層會將連接視為中斷，Home Assistant 則會報告攝像頭沒有流來源，或者顯示空白影像而不是即時畫面。
這已經被多次報告過。使用 ffmpeg 攝影機平台、go2rtc 以及通用攝影機整合嘗試時，結果都是一樣的：靜態預覽可以正常運作，但在 HomeKit 中的持續更新直播影像無法顯示。目前尚未有任何完全可用的設置被確認可用於此整合或其他類似的掃地機地圖串流。
Home Assistant 當機、重啟或大量使用記憶體 地圖支援
顯示答案
該整合呈現可縮放、高解析度的地圖影像，類似官方應用程式，這可能消耗大量記憶體。在記憶體有限的系統上，例如 Raspberry Pi、小型 VM 或受限於 2-3GB 記憶體的容器中，這可能會耗盡可用記憶體，導致 Home Assistant 凍結、重啟或完全無法啟動，通常發生在新增具有地圖支援的裝置後，或打開其裝置頁面或地圖攝影機時。
解決方法
從裝置的設定選項啟用 低解析度地圖圖像。這能解決大多數此類情況。
如果啟用該選項後仍然崩潰，地圖資料本身可能已損壞或隨時間異常變大，這也會在渲染過程中增加記憶體使用量。從 備份與恢復 還原舊的健康地圖可以解決此問題。如果兩者都無效，請 收集除錯日誌 並提交錯誤報告，因為這可能指向不同的潛在原因。
Home Assistant 更新後整合元件無法載入，並提到 py_mini_racer 地圖支援
顯示答案
該整合元件依賴於 py-mini-racer，這是一個用於優化和渲染地圖，使其與官方應用匹配的 JavaScript 引擎。這個依賴由 Home Assistant 自行安裝，而不是由整合元件安裝，並且在 Home Assistant Core 更新後，尤其是在基於 musl 的系統（例如某些平台上的 HAOS）或升級後不久，有時會安裝失敗或無法載入其原生二進位檔。
環境問題
這是環境/依賴安裝問題，而不是整合的程式碼可以偵測或解決的問題。它在不同的 Home Assistant 版本和安裝類型中反覆出現。
重新啟動 Home Assistant（讓它重試安裝依賴）在某些情況下可以解決問題。如果問題持續存在，請檢查 Home Assistant 在啟動時的日誌，找出實際的 pip/依賴安裝錯誤；需要解決的就是這個錯誤（如果看起來像是平台層級安裝失敗，也可能需要作為 Home Assistant Core 的問題處理）。
可以使用運行 Valetudo 的裝置與此整合嗎？
顯示答案
是也不是。從技術上來說，沒有任何限制阻止此整合與 Valetudo 一起運作。Valetudo 不會禁用本地 miIO API，因此只要能取得 token，設備就可以透過 本地連接 控制。然而，地圖數據無法通過本地 API 獲取，且 Valetudo 也不會透過服務公開原始地圖數據。因此，此整合在沒有地圖支援的情況下仍可運作。
在沒有地圖支援的情況下，此整合提供的功能大多變得冗餘，因為所有剩餘功能已可透過原生方法使用。 Valetudo Home Assistant MQTT 整合.