Konfiguration

Dieser Abschnitt behandelt die grundlegenden Optionen, um die Dreame Vacuum Card in Betrieb zu nehmen. Er beschreibt, wie die Staubsauger-Entität verbunden und die grundlegenden visuellen und Interaktions-Einstellungen angepasst werden können.

Minimale Konfiguration (entity)

Die Karte benötigt nur den entity-Parameter, um zu funktionieren, und es sind keine weiteren Konfigurationen erforderlich. Dies definiert die primäre Home Assistant-Entität für den Staubsauger, die zur dreame_vacuum-Integration gehören muss, wie z. B. vacuum.l10s_gen2. Sie erkennt automatisch die Fähigkeiten des Geräts basierend auf diesem einzigen Parameter.

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2

Grundkonfiguration

Die folgenden Parameter können verwendet werden, um das visuelle Design und die Interaktionsmodi der Karte zu ändern.

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

Titel (title)

Ein optionaler benutzerdefinierter Titel für den oberen Bereich der Karte. Standardmäßig wird der Anzeigename des Geräts aus Home Assistant verwendet.

Titel ausblenden

Falls gewünscht, kann der Kartentitel vollständig über den hidden_card_objects-Konfigurationsparameter deaktiviert werden. Wenn der Titel ausgeblendet ist, wird der aktuelle Zustand des Staubsaugers an seiner Stelle oben auf der Karte angezeigt.

Karten-Farbschema (color_scheme)

Definiert die Farbpalette, die auf verschiedene Elemente der Karte angewendet wird, wie Räume, Pfade und Wände.

Standardwert

Wenn dieser Parameter in der Konfiguration nicht angegeben ist, wird das in den Integrationseinstellungen ausgewählte Farbschema verwendet.

• Dreame Light (dreame_light): Offizielles Theme der Dreame-App.
• Dreame Dark (dreame_dark): Dunkles Theme, exklusiv für die dreame_vacuum-Integration.
• Dreame Auto (dreame_auto): Wechselt automatisch zwischen dreame_light und dreame_dark basierend auf dem System-Theme.
• Mijia Light (mijia_light): Offizielles Licht-Theme der Xiaomi Mi Home-App.
• Mijia Dark (mijia_dark): Offizielles Dunkel-Theme der Xiaomi Mi Home-App.
• Mijia Auto (mijia_auto): Wechselt automatisch zwischen mijia_light und mijia_dark basierend auf dem System-Theme.
• Grayscale (grayscale): Ein farbloses, monochromatisches Karten-Theme.

Farben überschreiben

Wenn die vordefinierten Farbschemata Ihren Anforderungen nicht entsprechen, können einzelne Farben vollständig über den override_colors-Konfigurationsparameter angepasst werden.

Karten-Symbolsatz (icon_set)

Steuert den ästhetischen Stil der Symbole, die direkt auf der Kartenoberfläche angezeigt werden, einschließlich der Lade- und Raum-Symbole.

Standardwert

Wenn dieser Parameter nicht in der Konfiguration angegeben wird, wird standardmäßig das in den Integrations-Einstellungen ausgewählte Symbolset verwendet.

• Dreame (dreame): Offizielles Symbolset der Dreame-App.
• Dreame Old (dreame_old): Legacy-Symbolset der Dreame-App.
• Mijia (mijia): Offizielles Symbolset der Xiaomi Mi Home-App.
• Material (material): Eingebaute Material Design-Symbole von HA.

Symbole ausblenden

Wenn die verfügbaren Symbolsets nicht Ihren visuellen Vorlieben entsprechen, kann die Sichtbarkeit bestimmter Symbole auf der Karte vollständig mit dem hidden_objects-Konfigurationsparameter deaktiviert werden.

Kartenanzeige (map_display)

Steuert den Anzeige-Stil der Karte und bestimmt die Sichtbarkeit der vom Roboter gescannten Karte, bearbeitbarer physischer Wände und Bodentexturen.

Nur auf unterstützten Geräten verfügbar

Die Grundrissanzeige-Modi sind strikt für Geräte verfügbar, die die 3D-Kartenanzeige v2 oder höher in der offiziellen App unterstützen. Auf älteren Geräten, die diese Funktion nicht unterstützen, sind diese spezifischen Konfigurationseigenschaften deaktiviert oder haben keine Wirkung, da die Kartendaten keine Wand- und Türinformationen enthalten, die angezeigt werden können.

Für nicht unterstützte Geräte wird dringend empfohlen, den Hintergrundbild-Konfigurationsparameter zu verwenden, um einen ähnlichen 2D- oder 3D-Grundrissanzeigeeffekt zu erzielen.

Standard (standard)

Zeigt die exakte Kartenansicht, wie sie vom Roboter gescannt wurde.

Grundriss (floor_plan)

Kombiniert die vom Roboter gescannte Kartenansicht mit der Anzeige bearbeitbarer physischer Wände.

Grundriss ohne Textur (floor_plan_without_texture)

Identisch mit floor_plan, versteckt jedoch die Textur für ungescannte Bereiche innerhalb der Wände und zeigt das vollständige Bodenmaterial des Raumes an.

Nur Grundriss (floor_plan_only)

Identisch mit floor_plan_without_texture, verbirgt jedoch die gescannte Kartenansicht vollständig und zeigt nur die Wände und den Innenboden an. Diese Ansicht ist sehr nützlich, um die Karte automatisch zuzuschneiden und zu zentrieren.

Vorschau

Standard

Grundriss

Grundriss ohne Textur

Nur Grundriss

Bearbeitbare Wände

Die in Grundriss-Modi angezeigten physischen Wände und Grenzen sind vollständig bearbeitbar. Weitere Details, wie Sie diese anpassen können, finden Sie im Abschnitt Wände unter Kartenverwaltung.

Karten-Sperrmodus (locked)

Diese Einstellung wird verwendet, um das Schwenken und Zoomen der Karte innerhalb der Karte zu sperren. Sie verhindert, dass die Karte beim Scrollen des Dashboards mit Touch oder Mausrad verschoben wird und die Seitenbewegung blockiert. Der Anfangswert ist auto. Dieser Mechanismus kann nach den folgenden Optionen konfiguriert werden:

Karten zurücksetzen und sperren

Wann immer die Karte sich nicht in ihrer ursprünglichen Reset-Position befindet, bleibt die Karte vollständig entsperrt, unabhängig vom definierten Sperrmodus. Um die Karte wieder zu sperren, muss ein Doppelklick oder ein Doppeltipp ausgeführt werden, um die Karte in ihre ursprüngliche Ansicht zurückzubringen.

Darüber hinaus kann die Karte unabhängig vom konfigurierten Sperrmodus immer durch einen Doppelklick oder Doppeltipp auf einen bestimmten Raum zum Hereinzoomen entsperrt werden.

Auto (auto)

Die Karte erkennt, ob sie sich innerhalb einer scrollbaren Steuerung befindet, und sperrt die Karte entsprechend dynamisch.

• Mausinteraktionen: Die Karte bleibt gesperrt, bis die Maus aktiv über der Karte bewegt wird. Wenn die Maus während eines Seiten-Scrolls auf der Karte landet, aber nicht bewegt wird, bleibt die Karte gesperrt. Wenn die Kartenansicht durch einen Doppelklick zurückgesetzt wird, sperrt die Karte sofort wieder, wodurch die Seite direkt nach einem Reset gescrollt werden kann, vorausgesetzt, die Maus wird nicht bewegt.
• Touch-Interaktionen: Die Karte ist anfänglich gesperrt. Zum Entsperren der Karte ist eine Touch-und-Halten-Aktion erforderlich, wobei die notwendige Haltezeit durch die Konfigurationseinstellung touch_lock definiert wird. Ein sofortiges Wischen scrollt die Dashboard-Seite, während kurzes Halten die Karte zum Verschieben entsperrt und einen Indikator anzeigt. Außerdem entsperrt ein Zwei-Finger-Pan, ein Zwei-Finger-Zoom oder ein Doppeltipp-Zoom die Karte sofort. Sobald die Karte durch eine dieser Touch-Methoden entsperrt wurde, bleibt sie entsperrt, bis die Ansicht durch einen Doppeltipp zurückgesetzt wird.

Nur Touch (only_touch)

Die Karte wird ausschließlich beim Ein-Finger-Verschieben gesperrt, während das ungehinderte Scrollen mit dem Mausrad erlaubt bleibt. Ein Zwei-Finger-Pan oder Zoom entsperrt die Karte, bis die Ansicht durch einen Doppeltipp zurückgesetzt wird, wodurch dieser Modus empfohlen wird, wenn häufiges Verschieben nicht notwendig ist.

Nie (never)

Die Karte wird niemals gesperrt und das Seiten-Scrolling ist immer blockiert.

Immer (always)

Die Karte ist überall erzwingend gesperrt. Während das manuelle Zoomen und Verschieben zunächst deaktiviert ist, bleibt das Zoomen durch Doppeltippen oder Doppelklicken verfügbar. Sobald durch ein Doppeltippen oder Doppelklicken gezoomt wurde, wird die Karte zum Verschieben freigegeben, bis die Ansicht durch ein weiteres Doppeltippen oder Doppelklicken zurückgesetzt wird.