地圖實體 地圖支援

該整合自動揭露各種專用於地圖視覺化和管理的實體。這些包括用於渲染即時和已保存地圖的動態攝像頭實體、用於管理多層樓佈局和地圖旋轉的選擇實體、用於觸發新地圖任務的按鈕實體，以及提供歷史數據和當前房間追蹤的感測器實體。

這些實體的可用性取決於設備的地圖支援功能和當前的連接方式。

多層地圖支援

最多三個已保存地圖，並自動生成攝像頭和選擇實體以管理多層地圖。

注意

已儲存的地圖使用 [original map id][version] 作為它們的 map_id 格式（例如 46）。因此地圖 ID 會不斷變化，不能用於實體 ID。取而代之的是，地圖攝影機實體使用索引系統。地圖索引是由按地圖 ID 排序的已儲存地圖列表創建的，並用於為沒有自訂名稱的地圖命名。因此，當 map_2 從列表中移除時，map_3 將被刪除，而 map_3 將變為 map_2（與官方應用處理方式完全相同）。如果在存在多個已儲存地圖時禁用多樓層地圖，map_1 將始終成為選定的地圖，而不是刪除其他地圖。

攝影機

名稱	描述	注意事項
map	即時地圖	即時地圖影像
map_data	用於 valetudo-card 的即時地圖資料	預設禁用
map_1	第一個已儲存地圖	索引 1 的已儲存地圖
map_2	第二個已儲存地圖	索引 2 的已儲存地圖，如果啟用多樓層地圖並且地圖列表中至少有兩個已儲存地圖時可用
map_3	第三個已儲存地圖	索引 3 的已儲存地圖，如果啟用多樓層地圖並且地圖列表中至少有三個已儲存地圖時可用
map_4	第四個已儲存地圖	儲存在索引4的地圖，若啟用多樓層地圖且地圖清單上至少有四個已儲存地圖時可用（僅適用於支援WiFi地圖的吸塵器）
wifi_map_1	第一個已儲存地圖的WiFi地圖	適用於支援WiFi地圖的吸塵器
wifi_map_2	第二個已儲存地圖的WiFi地圖	適用於支援WiFi地圖的吸塵器
wifi_map_3	第三個已儲存地圖的WiFi地圖	適用於支援WiFi地圖的吸塵器
wifi_map_4	第四個已儲存地圖的WiFi地圖	適用於支援WiFi地圖的吸塵器

只有在使用雲端連線時，攝影機實體才可用。所有攝影機實體的動態刷新率取決於上次請求的時間以及當前裝置狀態。地圖僅在提出影像請求時呈現，且僅更新影像的變更區域。

已儲存地圖的攝影機名稱會根據其索引或自訂名稱動態生成。對於多樓層設定，已儲存地圖實體使用索引系統而非地圖ID。 更多資訊

即時地圖無法直接編輯；編輯完成後，將呈現已儲存地圖，直到機器人開始新的清掃任務。

注意

map_1 實體在多樓層地圖功能被禁用時，總是呈現已儲存的當前選擇地圖。

有關地圖功能的更多信息

按鍵

名稱	描述	注意事項
start_fast_mapping	開始快速建圖	當達到最大地圖數量時不可用
start_mapping	創建新地圖並清掃整個樓層	當達到最大地圖數量時不可用
backup_saved_map	創建當前已儲存地圖的備份	在具有地圖備份功能的設備上可用

選擇

名稱	描述	注意事項
map_rotation	設定所選地圖的旋轉角度	可與地圖功能一起使用。當當前地圖不是所選地圖之一時不可用（已儲存的地圖可以設定不同的旋轉角度，但Only選擇地圖可以通過此實體進行編輯）
selected_map	當前選擇的地圖	可與地圖功能一起使用。當多樓層地圖被禁用或不可用時不可用（更改所選地圖時，機器人將結束當前活動工作）

房間選擇實體

房間選擇實體是從已儲存地圖動態生成的，用於編輯每個房間的自定義清掃設置。

有關自訂清潔功能的更多資訊

感測器

名稱	描述	注意事項
cleaning_history	以屬性形式顯示先前的清潔工作詳情	提供地圖功能
cruising_history	以屬性形式顯示先前的巡航工作詳情	提供地圖功能
current_room	吸塵器目前所在的房間	提供地圖功能