配置選項
在 Home Assistant 中，每個成功配置的機器人掃地機都會被存為一個獨立的整合項目。系統會自動創建相應的裝置並將其連結到該項目，並公開掃地機的實體、服務及地圖數據。配置選項提供對每個裝置的設定存取，允許獨立自訂每個整合項目的行為。
這些設定可以在初次設置過程中立即訪問，作為完成所選連接類型的配置後的最後一步（就在裝置被添加到 Home Assistant 之前）。也可以隨時從 Home Assistant 的 整合 頁面修改，方法是點擊位於裝置卡片右上角的 配置 按鈕。
Dreame Vacuum Card 金鑰
這是一個可選欄位，用於輸入 Dreame 吸塵器卡片 授權金鑰。當輸入有效金鑰時，整合會自動啟用內嵌的自訂卡片，並在儀表板的自訂卡片中提供使用。如果輸入無效金鑰，卡片將保持在儀表板的預覽模式中。
單一裝置啟用
每個授權金鑰僅限於單一裝置使用。一旦金鑰被啟用，它將永久綁定於該特定裝置，無法用於在其他裝置上啟用此卡片。
注意
此欄位完全可選。若留空，內嵌自訂卡片仍可新增至儀表板，但將以預覽模式運作。有效金鑰可隨時透過卡片在預覽模式中的介面直接取得。
通知
選擇此整合允許為此裝置建立哪種類別的 持久通知。取消勾選某個類別將完全停用該類別，即使該底層裝置事件仍然發生。
- 清理完成 (
cleanup_completed)：當清理任務成功完成時生成。 - 耗材 (
consumable)：當耗材壽命即將耗盡或組件需要維護時生成。 - 資訊 (
information)：用於一般資訊事件和狀態更新時生成。 - 警告 (
warning)：當設備遇到可清除的錯誤或輕微問題時生成。 - 錯誤 (
error)：當設備出現嚴重故障或硬體錯誤時生成。
伴侶應用程式
預設情況下，持久通知僅會顯示在 Home Assistant 儀表板內。它們無法直接推送到行動裝置上的 Home Assistant Companion App，因為需要特定的通知裝置 ID。要在行動裝置上接收推送通知，必須建立一個 自訂自動化，該裝置要麼監聽整合的 事件，要麼監控生成的持久通知，然後將它們轉發到特定的行動裝置。
地圖顯示選項 地圖支援
以下設置僅適用於已配置雲帳號的設備（DreameHome、MovaHome、TROUVER 或小米 Home），因為它們都依賴地圖數據：
Dreame 吸塵器卡片
以下設置僅適用於生成的地圖攝像頭實體。Dreame 吸塵器卡片 本身會顯示自己的地圖，並且可以通過其 高級配置 獨立覆蓋 色彩方案 和 圖標集。方形地圖圖像 和 低解析度地圖圖像 選項對自定義卡片無效，因此強烈建議啟用 低解析度地圖圖像 以節省記憶體。
色彩方案
選擇生成地圖圖像時使用的調色板。
- Dreame Light (
dreame_light)：官方 Dreame 應用的主題。 - Dreame Dark (
dreame_dark)：僅在dreame_vacuum集成中使用的深色主題。 - Mijia Light (
mijia_light)：官方小米米家應用的淺色主題。 - Mijia Dark (
mijia_dark)：官方小米米家應用的深色主題。 - Grayscale (
grayscale)：無色、單色地圖主題。 - Transparent (
transparent)：將地板、牆壁和房間填充生產為完全透明，適用於在自定義背景上疊加地圖。
圖示庫
選擇用於地圖標記的圖標樣式，例如機器人、充電器和家具，匹配官方應用的圖標集。
- Dreame (
dreame)：官方 Dreame 應用的圖標集。 - Dreame Old (
dreame_old)：舊版 Dreame 應用的圖標集。 - Mijia (
mijia)：官方小米米家應用的圖標集。 - Material (
material)：Home Assistant 內建的 Material Design 圖標。
隱藏的地圖物件
選擇哪些地圖元素將被排除在生成的地圖圖像之外。這對簡化地圖或隱藏特定儀表板不需要的信息非常有用。
可用對象
- Room Colors (
color)：每個房間的不同顏色填充。 - Room Icons (
icon)：基於房間類型的房間圖標。 - Room Names (
name)：房間名稱的文字標籤。 - Room Name Background (
name_background)：房間名稱背後的膠囊形背景及其相關顏色。 - 房間順序 (
order)：表示清掃順序的編號徽章。 - 房間吸力等級 (
suction_level)：表示房間設定吸力等級的圖示。 - 房間水量 (
water_volume)：表示房間設定水量的圖示。 - 房間清掃次數 (
cleaning_times)：表示房間將被清掃次數的徽章。 - 房間清掃模式 (
cleaning_mode)：表示房間設定清掃模式（掃地、拖地或兩者）的圖示。(僅在支援裝置上) - 房間拖地模式 (
mopping_mode)：表示房間設定拖布類型的圖示。(僅在支援裝置上) - 路徑 (
path)：顯示機器人清掃過路徑的路徑。 - 禁止區域 (
no_go)：限制區域。 - 禁止拖地區域 (
no_mop)：限制拖地區域。 - 虛擬牆 (
virtual_wall)：添加虛擬牆以防止機器人跨越。 - 虛擬邊界 (
pathway)：機器人必須小心跨越的定義邊界。（僅適用於支援的設備） - 活動區域 (
active_area)：在區域清掃時繪製的邊界框。 - 活動點 (
active_point)：顯示 1.5m² 面積的局部清掃點。 - 充電座圖示 (
charger)：基座圖示。 - 機器人圖示 (
robot)：代表機器人本身的圖示。 - 清潔方向 (
cleaning_direction)：指示機器人當前清掃方向的箭頭。 - AI 障礙物 (
obstacle)：AI 偵測到的障礙物圖示，如鞋子和電線。（僅適用於支援的設備） - 寵物 (
pet)：被偵測為寵物的障礙物。（僅適用於支援的設備） - 地毯區域 (
carpet)：地毯材質。（僅適用於支援的設備） - 地板材質 (
material)：房間地板的材質，如木地板或瓷磚。（僅適用於支援的設備） - 低窪區域 (
low_lying_area)：機器人通過降低其 LiDAR 掃描器進入的低區域。(僅適用於支援的設備) - 家具 (
furniture)：3D 或 2D 家具。(僅適用於支援的設備) - 斜坡 (
ramp)：環境中放置的斜坡。(僅適用於支援的設備) - 窗簾 (
curtain)：窗簾。(僅適用於支援的設備) - 巡航點 (
cruise_point)：前往操作點。(僅適用於支援的設備)
正方形地圖圖像
強制生成的地圖相機圖像為 1:1 正方形長寬比，而非地圖的自然邊界框，這對於需要正方形圖像的儀表板佈局可能很有用。
低解析度地圖圖像
以降低的解析度生成地圖相機圖像，以減少記憶體使用量並加快更新速度。
記憶體限制
生成大型地圖可能需要大量的記憶體。如果在導航到裝置頁面或存取地圖攝影機實體時 Home Assistant 崩潰並重新啟動，很可能是因為記憶體不足。啟用此選項通常可以解決此問題。
注意
啟用此選項也會停用 已保存的 WiFi 地圖 攝影機實體，因為其在低解析度下不可用。
優先使用雲端
只適用於使用 小米 Home 帳戶設定的裝置。此設定允許更新在初始設定步驟中選擇的偏好。
- 啟用時: 強制所有通訊通過雲端。這對於小米已禁用本地訪問功能的新裝置，或當裝置與 Home Assistant 位於不同子網時是必要的。
- 當停用時（建議用於支援的設定）： 此整合會與設備建立直接的本地連線（同時仍自動處理來自雲端的令牌和 IP 更新）。這保持所有通訊（地圖數據除外）完全在本地進行。
測試本地 API 可用性
此選項提供了一種非常有用的方法來測試本地連線。為確保初始設備設定順利進行而無錯誤，偏好雲端 可以在設定流程中保持啟用。一旦設備成功添加到 Home Assistant，這個選項可以在此處停用，以檢查設備是否實際支援本地 API。如果停用後設備變得不可用，只需重新啟用它以回退到雲端連線。
YAML 供參考
yaml
dreame_vacuum:
# Local connection
host: 192.168.1.100
token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6
# Cloud connection
username: your@email.com
password: your_password
country: de
prefer_cloud: true # Only available on Xiaomi Home
# Options available regardless of connection type
dvc_key: 123e4567-e89b-42d3-a456-426614174000
notify:
- information
- warning
- error
# Options available only with map support (Cloud)
color_scheme: dreame_dark
icon_set: dreame_old
hidden_map_objects:
- name_background
- name
- order
square: true
low_resolution: true