Skip to content

Valetudo 地图卡片 地图支持 ​

Valetudo 地图卡片 是一个专用的地图渲染卡,最初为 Valetudo 设计,但通过反向工程的地图数据生成过程及优化功能,完全兼容此集成。

Valetudo 地图Valetudo 地图

该卡不是显示预渲染的图像,而是利用专用的数据实体获取原始地图坐标,并直接在浏览器中渲染地图。这将渲染过程从 Home Assistant 服务器转移到前端,从而实现零后台资源消耗。对于运行在低资源硬件(CPU 或内存有限)的设备,可以禁用所有其他基于图像的摄像头实体,从而完全关闭后台渲染,同时仍通过此卡保留完整的地图可见性。

要求 ​

Valetudo 地图卡 依赖于 Map Data(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 地图卡使用自己的颜色索引算法。它不会渲染房间图标或名称,也会忽略集成地图数据中的地图旋转设置。然而,它生成地图图像的速度要快得多。

官方文档 ​