配置
本节介绍了启动 Dreame 吸尘器卡片的基本选项。它详细说明了如何连接吸尘器实体以及自定义核心的视觉和交互设置。
最小配置(entity)
该卡片仅需 entity 参数即可运行，无需其他配置。该参数定义了吸尘器的主要 Home Assistant 实体，该实体必须属于 dreame_vacuum 集成，例如 vacuum.l10s_gen2。它将基于此单一参数自动检测设备的功能。
yaml
type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2基本配置
以下参数可用于修改地图的视觉样式和交互模式。
yaml
type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
title: First Floor Vacuum
color_scheme: dreame_auto
icon_set: material
map_display: floor_plan
locked: only_touch标题(title)
卡片顶部的可选自定义标题。默认为 Home Assistant 中设备的友好名称。
隐藏标题
如有需要，可使用 hidden_card_objects 配置参数完全禁用卡片标题。当标题被隐藏时，卡片顶部将显示吸尘器的当前状态。
地图配色方案（color_scheme)
定义应用于地图上各个元素的颜色调色板，例如房间、路径和墙壁。
默认值
如果在配置中未提供此参数，则默认为集成设置中选择的配色方案。
- Dreame 亮色 (
dreame_light)：官方 Dreame 应用的主题。 - Dreame 暗色 (
dreame_dark)：仅限dreame_vacuum集成的暗色主题。 - Dreame 自动 (
dreame_auto)：根据系统主题在dreame_light和dreame_dark之间自动切换。 - 米家 亮色 (
mijia_light)：官方小米米家应用的亮色主题。 - 米家 暗色 (
mijia_dark)：官方小米米家应用的暗色主题。 - 米家 自动 (
mijia_auto)：根据系统主题在mijia_light和mijia_dark之间自动切换。 - 灰度 (
grayscale)：一种无色的单色地图主题。
覆盖颜色
如果预定义的配色方案不符合您的需求，可以使用 override_colors 配置参数完全自定义各个颜色。
地图图标集(icon_set)
控制直接显示在地图表面的图标的美学风格，包括充电器和房间图标。
默认值
如果配置中未提供此参数，则默认为集成设置中选择的图标集。
- Dreame (
dreame)：官方 Dreame 应用的图标集。 - Dreame Old (
dreame_old)：旧版 Dreame 应用的图标集。 - Mijia (
mijia)：官方小米米家应用的图标集。 - Material (
material)：HA 内置的 Material Design 图标。
隐藏图标
如果可用的图标集不符合您的视觉偏好，可以使用 hidden_objects 配置参数完全关闭地图上特定图标的可见性。
地图显示 (map_display)
控制地图的显示样式，决定机器人的扫描地图、可编辑物理墙壁和地面纹理的可见性。
仅在支持的设备上可用
楼层平面图显示模式仅适用于官方App中支持3D地图显示v2或更高版本的设备。在不支持此功能的旧设备上，这些特定的配置属性将被禁用或无效，因为地图数据中不会包含任何可显示的墙壁和门的信息。
对于不支持的设备，强烈建议使用背景图片配置参数以实现类似的2D或3D楼层平面图视觉效果。
标准 (standard)
显示机器人扫描的精确地图视图。
楼层平面图 (floor_plan)
将机器人的扫描地图视图与可编辑物理墙的显示结合起来。
无纹理楼层平面图 (floor_plan_without_texture)
与floor_plan相同，但隐藏墙内未扫描区域的纹理，并显示房间的完整地面材质。
仅楼层平面图 (floor_plan_only)
与 floor_plan_without_texture 相同，但会完全隐藏扫描的地图视图，仅显示墙壁和内部地面。此视图对于自动裁剪和居中地图非常有用。
预览
标准
楼层平面图
无纹理楼层平面图
仅楼层平面图
可编辑墙壁
在 平面图 模式下显示的物理墙壁和边界是完全可编辑的。有关如何调整它们的详细信息，请参阅 墙壁 部分，位于 地图管理 下。
卡片锁定模式 (locked)
此设置用于锁定卡片内地图的平移和缩放。它可以防止在使用触控或鼠标滚轮滚动仪表板时地图移动，从而阻挡页面滚动。初始值为 auto。此机制可以根据以下选项进行配置：
地图重置与锁定
每当地图不处于初始重置位置时，无论定义的锁定模式如何，卡片都保持完全解锁。要再次锁定地图，必须执行双击或双点操作以将地图返回到初始视图。
此外，无论配置的锁定模式如何，都可以通过双击或双点指定房间来放大，从而始终解锁地图。
自动(auto)
卡片会检测自己是否位于可滚动控件内，并相应地动态锁定地图。
- 鼠标交互：地图会保持锁定状态，直到鼠标在卡片上主动移动。如果在页面滚动期间鼠标停留在地图上但未移动，地图保持锁定状态。当通过双击重置地图视图时，地图会立即重新锁定，从而允许在重置后立即滚动页面，前提是鼠标未移动。
- 触控操作：地图初始为锁定状态。解锁地图需要长按操作，所需的按住时间由
touch_lock配置设置定义。立即滑动将滚动仪表板页面，而短暂按住会解锁地图以便平移并显示指示器。此外，执行双指平移、双指缩放或双击缩放将立即解锁地图。一旦通过任何这些触控方式解锁，地图将保持解锁状态，直到通过双击重置视图。
仅触控(only_touch)
地图仅在单指平移时锁定，同时允许无限制的鼠标滚轮滚动。双指平移或缩放将解锁地图，直到通过双击重置视图，因此当不需要频繁平移时，推荐使用此模式。
从不(never)
地图从不锁定，并且页面滚动始终被阻止。
总是(always)
地图在任何地方都被强制锁定。虽然手动缩放和平移最初被禁用，但仍然可以使用双击或双指双击进行缩放。一旦通过双击或双指双击放大后，地图就可以进行平移，直到通过另一次双击或双指双击重置视图为止。