安裝與使用
本指南說明如何在 Home Assistant 儀表板上運行 Dreame 吸塵器卡。它涵蓋了整合的前置需求、將卡片添加到現有儀表板的步驟以及設定建議的 面板模式 的說明。面板模式通過利用全螢幕提供最佳體驗，在平板和桌面顯示器上特別強大。
Dreame 吸塵器卡 作為 Dreame 吸塵器 Home Assistant 整合 的核心部分緊密整合。它 不是 可以單獨安裝的獨立卡片。
若要使用此卡片，必須安裝包含內建卡片的 dreame_vacuum 整合版本 v2.0.0 或更高。
前置需求
如果已經安裝了 Dreame 吸塵器 整合，此步驟可以安全忽略。
如果尚未安裝，獲取它的最簡單方法是通過 HACS。可以在 HACS > Integrations 下搜索 Dreame Vacuum 整合，並下載版本 v2.0.0 或更高版本。下載後必須 重新啟動 Home Assistant。整合設置完成後，卡片將自動在儀表板上可用。
實體優化
該卡片設計僅使用 vacuum、sensor.cleaning_history、sensor.cruising_history 和 camera.map 實體運作。它所需的一切都直接來自這四個核心實體。因此，可以安全地禁用設備頁面上的所有其他實體，包括已保存的地圖實體，以保持 Home Assistant 的清潔。
為了進一步減少 Home Assistant 實例的負載，可透過關閉伺服器端圖像生成，改為禁用 camera.map 實體並啟用 camera.map_data 實體。卡片會自動偵測到這一點，並在瀏覽器中直接顯示所有地圖。最低限度下，卡片只需啟用 vacuum 實體即可運作。雖然此時地圖不會被繪製，但所有與地圖無關的功能，例如清潔設定、停靠操作和基本控制，仍然完全可訪問和使用。
將卡片添加到您的儀表板
要將 Dreame 真空卡片 添加到 Home Assistant 儀表板：
- 打開 Home Assistant 並導航到所需的儀表板。
- 點擊右上角的 編輯儀表板 () 圖標。
- 點擊右下角的 添加卡片 () 按鈕。
- 在卡片選擇器中，搜尋並選擇 自訂：Dreame 真空卡片。
- 在卡片編輯器中，選擇了 Dreame Vacuum Entity，例如
vacuum.l10s_gen2。 - 點擊 保存 將卡片新增到儀表板。
使用面板模式（建議）
為了最佳使用體驗，特別是考慮到 Dreame Vacuum 卡片的廣泛地圖編輯器和功能，強烈建議使用 Home Assistant 的 面板模式。面板模式允許單張卡片佔據儀表板視圖的整個螢幕。
卡片在被放置於面板視圖時會自動檢測並移除背景顏色及外部邊框，以無縫融合儀表板主題。此外，所有內部 UI 元素完全支持面板模式，並會調整其佈局以充分利用擴展的螢幕空間。
單卡面板視圖設置
- 打開所需的儀表板，然後點擊右上角的 編輯儀表板 () 圖標。
- 點擊儀表板視圖標籤上方的 新增視圖 () 圖標。
- 在「新增視圖」對話框中，選擇 面板，單卡選項，位於 佈局 下拉選單中。
- 可選擇提供 標題（例如「吸塵器」）及 圖示（例如
mdi:robot-vacuum）。 - 點擊 儲存。
- 點擊右下角的 添加卡片 () 按鈕。
- 在卡片選擇器中，搜尋並選擇 自訂：Dreame 真空卡片。
- 在卡片編輯器中，選擇了 Dreame Vacuum Entity，例如
vacuum.l10s_gen2。 - 點擊 保存 將卡片新增到儀表板。
原生瀏覽器導航
當在面板模式使用或當它是視圖中唯一的卡片時，卡片會原生地處理瀏覽器導航。可以使用裝置的實體 返回按鈕 或滑動手勢來關閉對話框、取消選單或返回上一頁，行為與卡片自身的返回按鈕完全相同。這在行動裝置上尤其有用。為了維持穩定的使用體驗，卡片僅攔截「返回」操作，不處理「前往」導航。