配置
本節涵蓋啟動 Dreame 吸塵器卡片的基本選項。它詳細說明了如何連接吸塵器實體並自訂核心視覺與互動設置。
最少配置 (entity)
此卡片僅需 entity 參數即可運行，無需其他配置。此參數定義了吸塵器的主要 Home Assistant 實體，該實體必須屬於 dreame_vacuum 整合，例如 vacuum.l10s_gen2。它將自動檢測設備的功能，並基於此單一參數進行操作。
yaml
type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2基本配置
以下參數可用於更改地圖的視覺風格及互動模式。
yaml
type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
title: First Floor Vacuum
color_scheme: dreame_auto
icon_set: material
map_display: floor_plan
locked: only_touch標題 (title)
卡片頂部的可選自訂標題。預設為 Home Assistant 的設備友善名稱。
隱藏標題
如有需要，可使用 hidden_card_objects 配置參數完全禁用卡片標題。當標題隱藏時，卡片頂部會顯示吸塵器的當前狀態。
地圖配色方案（color_scheme)
定義應用於地圖上各種元素的色彩調色板，例如房間、路徑和牆壁。
預設值
如果在配置中未提供此參數，將默認為整合設置中選擇的配色方案。
- Dreame Light (
dreame_light)：官方 Dreame 應用的主題。 - Dreame Dark (
dreame_dark)：僅限dreame_vacuum整合的深色主題。 - Dreame Auto (
dreame_auto)：根據系統主題自動在dreame_light和dreame_dark之間切換。 - Mijia Light (
mijia_light)：官方小米米家應用的亮色主題。 - Mijia Dark (
mijia_dark)：官方小米米家應用的深色主題。 - Mijia Auto (
mijia_auto)：根據系統主題自動在mijia_light和mijia_dark之間切換。 - Grayscale (
grayscale)：無色單色地圖主題。
覆蓋顏色
如果預定義的配色方案不符合您的需求，可以使用 override_colors 配置參數完全自訂個別顏色。
地圖圖示組（icon_set)
控制直接顯示在地圖表面上的圖示的美學風格，包括充電座和房間圖示。
預設值
如果在配置中未提供此參數，則默認為整合設定中選擇的圖示集。
- Dreame (
dreame)：官方 Dreame 應用的圖示集。 - Dreame Old (
dreame_old)：舊版 Dreame 應用的圖示集。 - Mijia (
mijia)：官方小米米家應用的圖示集。 - Material (
material)：HA 內建的 Material Design 圖示。
隱藏圖示
如果可用的圖示集不符合您的視覺偏好，可使用 hidden_objects 配置參數完全關閉地圖上特定圖示的可見性。
地圖顯示 (map_display)
控制地圖的顯示風格，決定機器人掃描地圖、可編輯的實體牆壁和地板紋理的可見性。
僅在支持的設備上可用
「樓層平面圖」顯示模式僅適用於官方 App 中支援 3D 地圖顯示 v2 或更高版本的裝置。在不支援此功能的舊裝置上，這些特定的配置屬性會被禁用或無效，因為地圖數據中不會包含可以顯示的牆壁和門資訊。
對於不支援的裝置，強烈建議使用「背景圖片」配置參數以實現類似的 2D 或 3D 樓層平面圖視覺效果。
標準 (standard)
顯示由機器人掃描的精確地圖視圖。
樓層平面圖 (floor_plan)
將機器人掃描的地圖視圖與可編輯實體牆的顯示結合。
無紋理樓層平面圖 (floor_plan_without_texture)
與「floor_plan」相同，但隱藏牆內未掃描區域的紋理，並顯示房間完整的地板材質。
僅樓層平面圖 (floor_plan_only)
與 floor_plan_without_texture 相同，但完全隱藏掃描的地圖視圖，只顯示牆壁和內部地板。此視圖非常適合自動裁剪和置中地圖。
預覽
標準
平面圖
無紋理平面圖
僅平面圖
可編輯牆壁
在 樓層平面圖 模式中顯示的物理牆壁和界線是完全可編輯的。有關如何調整它們的更多詳細資訊，請參閱 牆壁 部分，位於 地圖管理 下。
卡片鎖定模式 (locked)
此設定用於鎖定地圖在卡片內的平移和縮放。它可防止在使用觸控或滑鼠滾輪滾動儀表板時，地圖平移而阻塞頁面滾動。初始值為 auto。此機制可依以下選項進行設定：
地圖重置與鎖定
每當地圖不處於初始重置位置時，無論定義的鎖定模式為何，卡片都會保持完全解鎖。要再次鎖定地圖，必須進行雙擊或雙點擊以將地圖恢復到初始視圖。
此外，無論配置的鎖定模式如何，都可以通過雙擊或雙點擊特定房間來放大，從而解鎖地圖。
自動（auto)
卡片會檢測自己是否位於可滾動控制元件內，並根據情況動態鎖定地圖。
- 滑鼠互動：地圖保持鎖定，直到滑鼠在卡片上主動移動。如果滑鼠在頁面滾動過程中落在地圖上但沒有移動，地圖仍保持鎖定。當地圖視圖通過雙擊重置時，地圖會立即再次鎖定，允許在重置後立即滾動頁面，前提是滑鼠沒有移動。
- 觸控互動：地圖最初是鎖定的。解鎖地圖需要長按操作，所需的按住時間由
touch_lock配置設置決定。立即滑動會滾動儀表板頁面，而短暫按住則會解鎖地圖以便平移並顯示指示器。此外，進行雙指平移、雙指縮放或雙擊縮放操作將立即解鎖地圖。通過任何這些觸控方法解鎖後，地圖將保持解鎖狀態，直到使用雙擊重設視圖。
僅觸控（only_touch)
地圖僅在單指平移時鎖定，但允許無限制的滑鼠滾輪滾動。雙指平移或縮放會解鎖地圖，直到使用雙擊重設視圖，因此當不需要頻繁平移時推薦使用此模式。
從不（never)
地圖從不鎖定，頁面滾動始終被阻止。
總是(always)
地圖在各處都被強制鎖定。雖然手動縮放和平移最初被禁用，但雙擊或雙點擊縮放仍然可用。一旦通過雙點擊或雙擊放大，地圖就可以自由平移，直到再次使用雙點擊或雙擊重設視圖。