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


该卡不是显示预渲染的图像,而是利用专用的数据实体获取原始地图坐标,并直接在浏览器中渲染地图。这将渲染过程从 Home Assistant 服务器转移到前端,从而实现零后台资源消耗。对于运行在低资源硬件(CPU 或内存有限)的设备,可以禁用所有其他基于图像的摄像头实体,从而完全关闭后台渲染,同时仍通过此卡保留完整的地图可见性。
要求
Valetudo 地图卡 依赖于 Map Data(camera.map_data)实体,该实体在集成中默认被禁用。在配置此卡之前,必须手动启用该实体。
启用地图数据实体的方法:
- 导航到 Home Assistant 中设备的设备页面。
- 向下滚动到 配置 部分,然后点击底部的链接以显示隐藏/禁用的实体。
- 找到并点击 当前地图数据 (
camera.map_data) 实体。 - 点击右上角的 设置 () 图标以打开实体设置。
- 切换实体为启用状态并保存更改。集成将自动重新加载。
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 地图卡使用自己的颜色索引算法。它不会渲染房间图标或名称,也会忽略集成地图数据中的地图旋转设置。然而,它生成地图图像的速度要快得多。