Benutzerdefinierte Kartenkonfiguration

Die Ausrichtung, Skalierung und das Hintergrundbild können für jede gespeicherte Karte auf dem Gerät unabhängig konfiguriert werden.

Diese Einstellungen können im visuellen Editor konfiguriert werden, indem eine Karte aus der Kartenliste ausgewählt wird, oder durch die Verwendung der map_config-Eigenschaft in der YAML-Konfiguration.

Kartenkonfigurationsoptionen

Die Einstellungen innerhalb von map_config werden pro Kartenindex unter Verwendung von Schlüsseln wie map_1, map_2 usw. angewendet. Jede der folgenden Optionen kann unter einer bestimmten Karte definiert werden:

Warnung

Kartenindizes werden basierend auf ihrer Erstellungsreihenfolge vergeben, wobei die älteste Karte den niedrigsten Index erhält, beginnend bei 1. Wenn jedoch die Mehrfach-Etagen-Kartenfunktion auf einem Gerät deaktiviert ist, das mehrere Karten und deren Konfigurationen enthält, wird die derzeit aktive Karte automatisch auf Index 1 neu zugewiesen. Dies bedeutet, dass eine zuvor unter einem anderen Index konfigurierte Karte plötzlich die Konfiguration von map_1.

• rotation: Überschreibt die im Kartendaten konfigurierte Drehung, um die Karte in einer für diese Karte spezifischen benutzerdefinierten Drehung zu zeichnen, wobei Werte von 0, 90, 180 oder 270 akzeptiert werden.
• scale: Überschreibt die automatische Maßstabsberechnung basierend auf dem Unterschied zwischen der ursprünglichen Größe der Karte und der Größe der Karte, wobei Werte zwischen 0.1 und 20 akzeptiert werden.
• object_scale: Überschreibt die automatisch berechnete Größe der Kartenobjekte, wie Raum- und Hindernissymbole, wodurch sie größer oder kleiner angezeigt werden können.
• opacity: Globale Transparenz der gezeichneten Karte. Der Anfangswert ist 1 und es werden Werte bis zu 0 akzeptiert.
• object_opacity: Transparenz der auf der Karte gezeichneten Objekte, wie Raum- oder Hindernissymbole. Der Anfangswert ist 1 und es werden Werte bis zu 0 akzeptiert.
• font_size: Schriftgröße für Textblasen, die über aktivierte Objekte angezeigt werden. Es werden Werte zwischen 0 und 12 akzeptiert.
• hidden_objects: Überschreibt die im globalen Erweiterte Konfiguration definierten versteckten Kartenobjekte für diese spezifische Karte.

Zentrierung und Skalierung

Die untenstehenden Parameter werden verwendet, um die Größe und die Mittelpunktkoordinaten zu überschreiben, die die Karte automatisch berechnet, um die Karte zu zeichnen.

Warnung

Die für diese Parameter angegebenen Werte beziehen sich auf die rohen, unskalierten Dimensionen der Karte, nicht auf die absoluten Pixel auf dem Bildschirm. Da das manuelle Berechnen dieser relativen Koordinaten sehr komplex ist, können die genauen benötigten Werte mithilfe des Live-Karteninformationen-Abschnitts des visuellen Editors extrahiert werden.

• left: Überschreibt den automatisch berechneten horizontalen Mittelpunkt der Karte. Zum Beispiel würde das Setzen dieses Wertes auf 0 die 0-Koordinate der Karte auf der X-Achse genau in die horizontale Mitte der Karte setzen. Dieser Punkt befindet sich typischerweise direkt vor dem Dock.
• top: Überschreibt den automatisch berechneten vertikalen Mittelpunkt der Karte. Zum Beispiel würde das Setzen dieses Wertes auf 0 die 0-Koordinate der Karte auf der Y-Achse genau in die vertikale Mitte der Karte setzen. Dieser Punkt befindet sich typischerweise direkt vor dem Dock.
• width: Überschreibt die tatsächliche Breite der Karte, die für die Fit-Berechnung verwendet wird. Da die Karte die Karte basierend auf der größten passenden Dimension skaliert, wird die Eingabe eines Werts, der größer als die tatsächliche Breite der Karte ist, die Karte innerhalb der Karte verkleinern, während ein kleinerer Wert sie vergrößern wird.
• height: Überschreibt die tatsächliche Höhe der Karte, die für die Fit-Berechnung verwendet wird. Ähnlich wie bei der width-Eigenschaft wird die Eingabe eines Werts, der größer als die tatsächliche Höhe der Karte ist, die Karte innerhalb der Karte verkleinern, während ein kleinerer Wert sie vergrößern wird.

YAML-Beispiel

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
map_config:
  map_1:
    rotation: 90
    scale: 1.2
    object_scale: 1.5
    left: 10
    top: -20
    hidden_objects:
      - name
      - virtual_wall
  map_2:
    rotation: 180
    opacity: 0.8

Hintergrund- und Überlagerungsbilder

Die Karte unterstützt das Rendern eines benutzerdefinierten Hintergrundbildes hinter der Karte, was besonders nützlich für die Erstellung immersiver 3D-Grundriss-Dashboards ist. Dieses Verhalten wird über die background_image-Eigenschaft konfiguriert.

Um den 3D-Effekt weiter zu verstärken, kann optional auch ein overlay_image bereitgestellt werden. Das Overlay-Bild wird direkt über dem Reinigungsweg des Roboters gezeichnet und dient in erster Linie dazu, Wege, die hinter physischen Wänden oder Möbeln im Grundriss verlaufen, visuell zu verdecken. Die Kombination sowohl eines Hintergrund- als auch eines Overlay-Bildes wird dringend empfohlen, um in 3D-Dashboards ein realistisches Tiefengefühl zu erzeugen.

Gestaltung eines 3D-Grundrisses

Beim Erstellen benutzerdefinierter Grafiken für einen 3D-Grundriss muss das Design als zwei separate Bilder mit transparentem Hintergrund exportiert werden: eine Basisebene, die Böden und niedrige Möbel enthält, und eine obere Ebene, die nur die oberen Wände enthält.

Die unten gezeigten Beispielbilder, dargestellt über einem Schachbrettmuster, um ihre transparenten Bereiche hervorzuheben, wurden mit der kostenlosen Innenarchitektur-Anwendung Sweet Home 3D erstellt und anschließend in einer Standard-Bildbearbeitungssoftware bearbeitet, um die Bodenflächen zu entfernen und die erforderlichen transparenten Bereiche zu erzeugen.

Hintergrundbild

Overlay-Bild

Die background_image- und overlay_image-Eigenschaften unterstützen die folgenden Parameter zur Ausrichtung des Grundrisses:

• url: Pfad des Bildes, zum Beispiel /local/first_floor_bg.
• opacity: Transparenz des Bildes. Der Anfangswert ist 1 und es werden Werte bis 0 akzeptiert.

Zentrieren und Skalieren von Bildern

Die left-, top-, width- und height-Eigenschaften für Bilder funktionieren mit derselben relativen Koordinatenlogik wie die eigene Zentrierung und Skalierung-Konfiguration der Karte. Diese Eigenschaften sind vollständig optional.

Auch wenn das benutzerdefinierte Bild perfekt zur Kartengröße passt, wird dringend empfohlen, mindestens top- und left-Werte anzugeben. Dies stellt sicher, dass das benutzerdefinierte Bild auch dann sicher an derselben relativen Position bleibt, wenn sich die Gesamtabmessung der Karte in Zukunft ändert.

Standardwerte

Wenn diese Werte nicht angegeben werden, gleicht die Karte automatisch die Größe und das Zentrum des benutzerdefinierten Bildes mit den Kartendaten ab. Diese Eigenschaften sind völlig optional und existieren ausschließlich, um dieses Verhalten zu überschreiben, sodass das benutzerdefinierte Bild weder verschoben noch in seiner Skala verändert wird, falls die Karte im Laufe der Zeit größer oder kleiner wird.

• left: Definiert das horizontale Zentrum des Bildes relativ zum Zentrum der Karte. Zum Beispiel platziert das Setzen dieses Wertes auf 0 die 0-Koordinate der Karte auf der X-Achse genau in der horizontalen Mitte des Bildes. Dieser Punkt befindet sich typischerweise direkt vor dem Dock.
• top: Definiert das vertikale Zentrum des Bildes relativ zum Zentrum der Karte. Zum Beispiel platziert das Setzen dieses Wertes auf 0 die 0-Koordinate der Karte auf der Y-Achse genau in der vertikalen Mitte des Bildes. Dieser Punkt befindet sich typischerweise direkt vor dem Dock.
• width: Definiert die Breite des Bildes relativ zum ursprünglichen, unskalierten Koordinatensystem der Karte, anstatt absolute Bildschirm-Pixel. Beispielsweise sorgt die Einstellung dieses Wertes so, dass er der Rohbreite der Karte entspricht, dafür, dass das Bild proportional skaliert wird, um genau denselben horizontalen Bereich wie die Kartendaten abzudecken.
• height: Definiert die Höhe des Bildes relativ zum ursprünglichen, unskalierten Koordinatensystem der Karte. Beispielsweise sorgt die Einstellung dieses Wertes so, dass er der Rohhöhe der Karte entspricht, dafür, dass das Bild proportional skaliert wird, um genau denselben vertikalen Bereich wie die Kartendaten abzudecken.

Native Drehung

Benutzerdefinierte Bilder haben keine eigene unabhängige Rotations-Eigenschaft; ihre Drehung ist inhärent an die Drehung der Karte gebunden. Um eine Ausrichtung über alle Ansichten hinweg sicherzustellen, muss die Grundorientierung des gestalteten Bildes genau der anfänglichen Orientierung der Karte entsprechen, wenn sie auf 0 Grad eingestellt ist.

Geräte-Pixel-Verhältnis (DPR)

Die Karte rendert die Karte entsprechend dem Pixelverhältnis des Bildschirms des Geräts. Um zu verhindern, dass Hintergrund- und Overlay-Bilder auf hochauflösenden Displays wie Mobiltelefonen verschwommen erscheinen, wird dringend empfohlen, diese Bilder mindestens doppelt so groß wie erforderlich auf dem Desktop-Dashboard bereitzustellen.

Bestimmung der Bildgröße

Die Kartendaten enthalten eine grid_size-Eigenschaft, die angibt, wie viele Millimeter ein einzelner Pixel in der realen Welt darstellt. Dieser Wert kann im Abschnitt Live-Karteninformationen gefunden werden. Zum Beispiel bedeutet ein grid_size von 50, dass jeder Pixel 50 mm oder 5 cm entspricht. Durch die Division der realen Abmessungen des Hauses durch diesen grid_size können die genauen width und height-Werte, die in der Konfiguration eingegeben werden müssen, genau berechnet werden, wodurch sichergestellt wird, dass ein 1:1-Grundrissbild perfekt mit der realen Größe des Hauses skaliert.

YAML-Beispiel

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

map_config:
  map_1:
    object_scale: 7
    width: 250
    height: 183
    opacity: 0.45
    hidden_objects:
      - customized_cleaning
      - floor
      - name
      - name_background
      - no_go
      - no_mop
      - order
      - walls
    background_image:
      url: /local/home.png
      left: 77
      top: 10.3
      width: 250
      height: 183
      opacity: 0.75
    overlay_image:
      url: /local/home_overlay.png
      opacity: 0.9
  map_2:
    left: 41
    top: -12
    width: 269
    height: 171
    background_image:
      url: /local/second_floor_bg.png