Lokalisierung

Die Dreame-Vakuumkarte unterstützt von Haus aus mehrere Sprachen. Sie verwendet dynamisch die vom Backend dreame_vacuum bereitgestellten Sprachdateien, anstatt separate Lokalisierungsdateien zu pflegen.

Die Karte ruft lokalisierte Textwerte aus dem entity_component-Abschnitt innerhalb des dreame_vacuum Integrations-Übersetzungsdateien ab.

Übersetzungsschlüssel

Innerhalb der Sprachdateien verwendet die Karte hauptsächlich mehrere Schlüssel-Kategorien, die mit frontend_ beginnen, um ihre Benutzeroberfläche anzuzeigen:

• frontend_action: Dieser Abschnitt enthält alle Texte, die innerhalb der Aktionsschaltflächen im Hauptsteuerungsfeld der Karte verwendet werden, wie Start, Pause oder Andocken.

• frontend_config: Dieser Abschnitt enthält alle Textbeschriftungen, Beschreibungen und Einstellungen, die innerhalb des visuellen Karten-Konfigurators verwendet werden.

• frontend_message: Enthält Statusmeldungen, Alarme, Fehlerberichte und Warnungen, die auf der Karte angezeigt werden.

• frontend_title: Deckt die Überschriften und Abschnittstitel ab, die innerhalb der Menüs der Karte verwendet werden, wie Kartenverwaltung oder Reinigungseinstellungen.

• entity: Dieser Block deckt Home Assistant-Entity-Domains wie select, sensor, switch, number, time und input ab. Die Karte zieht dynamisch die Namen und Zustände dieser Entitäten, wie Saugstufe oder Leise, direkt aus der Integration, um Konsistenz zu gewährleisten.

  • Karten-spezifische Zustände: Bietet Übersetzungen für interne Zustände, die ausschließlich von der Benutzeroberfläche der Karte verwendet werden und nicht von Home Assistant-Entitäten stammen. Dies umfasst Raumnamen (abgeleitet von der segment_name-Entität) sowie spezifische Bezeichner wie task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method und recovery_map_type.

Datums-, Zeit- und Einheitenformatierung

Neben der Textübersetzung passt sich die Karte automatisch an lokale Formatierungsvorgaben an, ohne dass eine manuelle Konfiguration erforderlich ist:

• Sprache & Gebietsschema: Die Karte priorisiert die im Home Assistant-Profil ausgewählte Sprache. Wenn dort keine Sprache explizit festgelegt ist, fällt sie automatisch auf die Standardsprache des Webbrowsers zurück.
• 12/24-Stunden-Zeitformat: Die Karte respektiert das in dem Home Assistant-Profil konfigurierte Zeitformat. Falls nicht angegeben, übernimmt sie automatisch das Standardzeitformat der Region des Geräts.
• Erster Tag der Woche: Die Karte liest die Einstellung für den ersten Tag der Woche direkt aus Home Assistant aus. Wenn nicht definiert, wird dynamisch bestimmt, ob der Kalender in der lokalen Region auf Sonntag oder Montag beginnen soll.
• Einheitensystem: Die Karte überprüft kontinuierlich die globale Konfiguration von Home Assistant. Verwendet das System das imperiale Einheitensystem, berechnet die Karte Flächen und Distanzen automatisch neu und zeigt sie nativ in Fuß, Quadratfuß oder Yard an.
• Native Unit-Übersetzungen: Gängige Einheitensuffixe und Abkürzungen, wie Meter, Kilometer, Fuß, Yard, Minute und Stunde, erfordern keine manuelle Übersetzung. Die Karte übersetzt sie automatisch mithilfe integrierter Browserfunktionen, die speziell auf die aktive Sprache abgestimmt sind.

Übersetzungen korrigieren oder verbessern

Wenn ein Tippfehler oder eine falsche Übersetzung festgestellt wird oder Unterstützung für eine neue Sprache benötigt wird, gehen Beiträge in das Haupt-dreame_vacuum-Integrationsrepository.

Übersetzungsverallgemeinerung

Die offizielle App verwendet häufig unterschiedliche Terminologie für identische Parameter über verschiedene Gerätegenerationen hinweg. Übersetzungen müssen logische, verallgemeinerte Bezeichnungen verwenden, anstatt die genaue Formulierung der App strikt zu übernehmen. Dies verhindert Übersetzungskonflikte, bei denen eine Korrektur, die auf eine bestimmte Generation zugeschnitten ist, anschließend von Benutzern mit anderen Gerätegenerationen überschrieben wird.

Der Aktualisierungsprozess umfasst die folgenden Schritte:

1. Das Repository forken: Forken des Dreame Vacuum Home Assistant Integrations-Repositorys auf GitHub.
2. Die Übersetzungsdatei finden: Navigieren zum custom_components/dreame_vacuum/translations/-Verzeichnis im geforkten Repository, um die Übersetzungsdatei zu finden, die dem Sprachcode entspricht, wie de.json oder it.json.
3. Die Änderungen vornehmen: Aktualisierung des falschen Textes. Die frontend_action-, frontend_config-, frontend_message- und frontend_title-Blöcke verwalten UI-bezogene Texte. Der entity-Block verwaltet Sensornamen, Auswahloptionen und deren Zustände.
4. Einen Pull Request einreichen: Öffnen eines Pull Requests zum Hauptrepository. Nachdem der Pull Request überprüft und in eine neue Version der Integration übernommen wurde, übernimmt die Dreame Vacuum Card automatisch die aktualisierten Übersetzungen.