安装与使用

本指南说明了如何在 Home Assistant 仪表板上运行 Dreame 真空吸尘器卡。它涵盖了集成的前提条件、将卡添加到现有仪表板的步骤以及设置推荐的 面板模式 的说明。面板模式通过利用全屏提供最佳体验，在平板电脑和桌面显示器上尤其强大。

---

Dreame 真空吸尘器卡 作为 Dreame 真空吸尘器 Home Assistant 集成 的核心部分紧密集成。它 不是 单独安装的独立卡。

要使用此卡，必须安装 dreame_vacuum 集成版本 v2.0.0 或更高，其中包括内置卡。

前提条件

如果已经安装了 Dreame 真空吸尘器 集成，则此步骤可以安全忽略。

如果尚未安装，获取它的最简单方法是通过 HACS。可以在 HACS > 集成 中搜索 Dreame 吸尘器 集成，并下载版本 v2.0.0 或更高版本。下载后需要 重启 Home Assistant。集成设置完成后，该卡片将自动在仪表板中可用。

实体优化

该卡片设计仅使用 vacuum、sensor.cleaning_history、sensor.cruising_history 和 camera.map 实体运行。它所需的一切都直接来自这四个核心实体。因此，设备页面上的所有其他实体，包括保存的地图实体，都可以安全地禁用，以保持 Home Assistant 的整洁。

为了通过关闭服务器端图像生成来进一步减少 Home Assistant 实例的负载，可以禁用 camera.map 实体，并改为启用 camera.map_data 实体。该卡会自动检测到这一点，并在浏览器中直接显示所有地图。最低限度下，仅启用 vacuum 实体时卡片也可以正常工作。虽然此状态下地图不会绘制，但所有与地图无关的功能，例如清洁设置、回充操作和基本控制，仍然可以完全访问和使用。

将卡添加到仪表盘

要将 Dreame 吸尘器卡 添加到 Home Assistant 仪表盘：

1. 打开 Home Assistant 并导航到所需的仪表盘。
2. 点击右上角的 编辑仪表盘 () 图标。
3. 点击右下角的 添加卡片 () 按钮。
4. 在卡片选择器中，搜索并选择 自定义：Dreame 吸尘器卡。
5. 在卡片编辑器中，选择 Dreame Vacuum 实体，例如 vacuum.l10s_gen2。
6. 保存 以将卡片添加到仪表板。

使用面板模式（推荐）

为了获得最佳用户体验，尤其考虑到 Dreame Vacuum 卡片的广泛地图编辑器和功能，强烈推荐使用 Home Assistant 的 面板模式。面板模式允许单个卡片占据整个仪表板视图的屏幕。

卡片在放置于面板视图时会自动检测，并移除背景颜色和外边框，以与仪表板主题无缝融合。此外，所有内部 UI 元素完全支持面板，并会调整布局以充分利用扩展的屏幕空间。

单卡片面板视图设置

1. 打开所需的仪表板，然后点击右上角的 编辑仪表板 () 图标。
2. 点击仪表板视图选项卡顶部旁边的 添加视图 () 图标。
3. 在“添加视图”对话框中，面板，选择单卡选项，在 布局 下拉菜单中选择。
4. 可以提供可选的 标题，例如“吸尘器”，以及 图标，例如 mdi:robot-vacuum。
5. 点击 保存。
6. 点击右下角的 添加卡片 () 按钮。
7. 在卡片选择器中，搜索并选择 自定义：Dreame 吸尘器卡。
8. 在卡片编辑器中，选择 Dreame Vacuum 实体，例如 vacuum.l10s_gen2。
9. 保存 以将卡片添加到仪表板。

原生浏览器导航

当在面板模式下使用或当它是视图中唯一的卡片时，该卡片原生处理浏览器导航。可以使用设备的物理 返回按钮 或滑动手势来关闭对话框、取消菜单或返回，就像使用卡片自身的返回按钮一样。这在移动设备上尤其有用。为了保持稳定的用户体验，卡片仅拦截“返回”操作，不处理“前进”导航。