Skip to content

Valetudo 地圖卡片 地圖支援 ​

Valetudo 地圖卡片 是一個專門的地圖呈現卡,最初為 Valetudo 設計,但通過逆向工程的地圖數據生成過程並具備優化功能,完全兼容此整合。

Valetudo 地圖Valetudo 地圖

此卡並非顯示預先渲染的圖像,而是利用專用數據實體獲取原始地圖座標,並直接在瀏覽器中渲染地圖。這將渲染過程從 Home Assistant 伺服器轉移到前端,從而實現後端資源消耗為零。對於運行在低資源硬體(CPU 或 RAM 限制)的安裝,所有其他基於圖像的攝影機實體都可以被禁用,以完全關閉後端渲染,同時仍通過此卡保留完整地圖可視化。

需求 ​

Valetudo 地圖卡 仰賴 地圖數據 (camera.map_data) 實體,此實體在整合中預設為禁用。配置此卡之前,必須手動啟用該實體。

要啟用地圖數據實體:

  1. 導航到 Home Assistant 中該裝置的裝置頁面。
  2. 向下捲動到 配置 區塊,並點擊底部的連結以顯示隱藏/已禁用的實體。
  3. 找到並點擊 當前地圖數據 (camera.map_data) 實體。
  4. 點擊右上角的 設定 () 圖標以打開實體設定。
  5. 切換實體為啟用並儲存更改。整合將自動重新載入。
yaml
type: custom:valetudo-map-card
vacuum: # Your vacuum name not the entity id
rotate: 0 # Map rotation entity does not work on valetudo map card
dock_icon: mdi:lightning-bolt-circle
dock_color: rgb(105 178 141)
vacuum_color: rgb(110, 110, 110)
wall_color: rgb(159, 159, 159)
floor_color: rgb(221, 221, 221)
no_go_area_color: rgb(177, 0, 0)
no_mop_area_color: rgb(170, 47, 255)
virtual_wall_color: rgb(199, 0, 0)
virtual_wall_width: 1.5
currently_cleaned_zone_color: rgb(221, 221, 221)
path_color: rgb(255, 255, 255)
path_width: 1.5
segment_opacity: 1
segment_colors:
  - rgb(171, 199, 248)
  - rgb(249, 224, 125)
  - rgb(184, 227, 255)
  - rgb(184, 217, 141)

儀表板限制

由於地圖圖像渲染是在瀏覽器中進行的,Valetudo 地圖卡使用自身的顏色索引演算法。它不渲染房間圖示或名稱,並忽略整合地圖數據中的地圖旋轉設定。然而,它生成地圖圖像的速度要快得多。

官方文件 ​