Erweiterte Konfiguration

Dieser Abschnitt behandelt zusätzliche Konfigurationsoptionen, die über die grundlegende Einrichtung hinausgehen. Während die Grundeinstellungen alles bieten, was erforderlich ist, um die Karte zum Laufen zu bringen, ermöglichen diese erweiterten Parameter eine tiefgehende Anpassung ihres Verhaltens und Erscheinungsbildes.

Mit diesen Einstellungen können Sie die Layout-Abmessungen anpassen, um perfekt in Ihr Dashboard zu passen, Barrierefreiheitsoptionen konfigurieren, die Sichtbarkeit bestimmter UI-Elemente verwalten und die Standardkartenfarben vollständig überschreiben.

Volle Höhe (full_height)

Da die Karte vollständig schwenkbar und zoombar ist, wurde die Karte ausdrücklich so gestaltet, dass sie unter keinen Umständen höher als der Bildschirm dargestellt wird. Dies stellt sicher, dass die gesamte Kartenansicht immer innerhalb des Ansichtsfensters passt, ohne dass die Seite gescrollt werden muss.

Wenn Sie dieses beabsichtigte Design überschreiben möchten, können Sie diesen Parameter auf false setzen. Wenn deaktiviert, skaliert die Karte immer so, dass sie die maximale verfügbare Breite ausfüllt, selbst wenn die resultierende Höhe die Bildschirmgrenzen überschreitet.

Nicht empfohlen

Das Einstellen dieses Parameters auf false wird im Allgemeinen nicht empfohlen. Es kann die Navigation und die Gesamterfahrung des Dashboards negativ beeinflussen und kann eine unnötige Sperrung der Verschiebefunktion der Karte verursachen, es sei denn, es ist anderweitig im locked-Konfigurationsparameter konfiguriert.

Seitenverhältnis (aspect_ratio)

Dies definiert das Seitenverhältnis des Kartenanzeigebereichs. Zum Beispiel bedeutet ein Wert von 1.5, dass die Breite 1,5-mal so groß wie die Höhe ist. Es kann je nach Form des Grundrisses zwischen 0.1 und 100 eingestellt werden.

Wichtig

Wenn full_height nicht auf true gesetzt ist, wird die Karte niemals höher als die Ansicht angezeigt, unabhängig vom angegebenen Seitenverhältnis.

Linkshänder-Modus (left_handed)

Wird dieser Parameter auf true gesetzt, werden die Aktionsschaltflächen und die zugehörigen Menüs auf der linken Seite der Karte angezeigt, anstatt auf der rechten Seite, vorausgesetzt, die Karte ist breit genug, damit der Inhalt rechts ausgerichtet werden kann.

Haptisches Feedback deaktivieren (disable_haptic)

Wenn dieser Parameter auf true gesetzt wird, werden die haptischen Feedback-Vibrationen deaktiviert, die durch die Karte während der UI-Interaktionen auf mobilen Geräten mit haptischer Funktion ausgelöst werden.

Wichtig

Haptisches Feedback für Erfolg und Misserfolg von Serviceaufrufen kann nicht deaktiviert werden. Dies stellt die Konsistenz mit dem Standardverhalten von Home Assistant für interaktive Komponenten wie Schalter und Auswähler sicher, die Serviceaufrufe auslösen.

Touch-Sperrdauer (touch_lock)

Überschreibt die standardmäßige 100 ms lange Touch-Entsperr-Haltdauer, die in den auto- und only_touch-Modi verwendet wird, wie im Abschnitt Kartensperrmodus beschrieben. Es werden Werte zwischen 100 und 400 ms akzeptiert.

Legacy-Schalter (legacy_switches)

Wenn dieser Parameter auf true gesetzt wird, werden die Schalter auf das alte Material-Toggle-Design zurückgesetzt, anstatt das neuere Toggle-Design zu verwenden, das in Home Assistant 2026.5 eingeführt wurde.

Warnung

Wenn die installierte Version von Home Assistant älter als 2026.5 ist, hat das Setzen dieses Parameters auf true keine Wirkung, da das Legacy-Schalter-Design bereits nativ verwendet wird.

Skripte (scripts)

Eine Liste von Home Assistant Script-Entitäten, wie z. B. - script.sweep_living_room, die direkt zur Shortcuts-Liste des Staubsaugers auf dem Startbildschirm hinzugefügt werden.

Die Shortcuts-Liste zeigt diese Skripte mit ihren Entitätsnamen neben einer Start ()-Schaltfläche an. Sie werden ganz oben in der Shortcuts-Liste eingefügt und behalten die genaue Reihenfolge bei, die in der Konfiguration festgelegt ist. Das bedeutet, dass benutzerdefinierte Skripte vor den nativen Shortcuts des Roboters angezeigt werden.

Darüber hinaus, wenn das Staubsauggerät Shortcuts nicht nativ unterstützt, erzwingt die Definition von Skripten hier, dass die Schaltfläche für Shortcut-Aktionen auf dem Startbildschirm sichtbar wird. Dies ermöglicht es der Karte, ähnliche Shortcut-Funktionalität über Home Assistant für nicht unterstützte Geräte bereitzustellen.

YAML-Beispiel

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
aspect_ratio: 1.5
full_height: true
touch_lock: 200
disable_haptic: true
left_handed: true
legacy_switches: true
scripts:
  - script.sweep_living_room
  - script.mop_kitchen