Lokalisatie

De Dreame Vacuum-kaart ondersteunt van nature meerdere talen. Het maakt dynamisch gebruik van de taalbestanden die door de backend dreame_vacuum-integratie worden geleverd, in plaats van aparte lokalisatiebestanden bij te houden.

De kaart haalt gelokaliseerde tekstwaarden op uit de entity_component-sectie binnen de dreame_vacuum integratie vertaalbestanden.

Vertaal Sleutels

Binnen de taalbestanden gebruikt de kaart voornamelijk verschillende sleutelcategorieën die beginnen met frontend_ om de interface weer te geven:

• frontend_action: Deze sectie bevat alle tekst die wordt gebruikt in de actieknoppen op het hoofdbedieningspaneel van de kaart, zoals Start, Pauze of Dock.

• frontend_config: Deze sectie bevat alle tekstlabels, beschrijvingen en instellingen die worden gebruikt in de visuele kaartconfigurator UI.

• frontend_message: Bevat statusberichten, meldingen, foutmeldingen en waarschuwingen die op de kaart worden weergegeven.

• frontend_title: Omvat de kopjes en sectietitels die worden gebruikt binnen de menu's van de kaart, zoals Kaartbeheer of Schoonmaakinstellingen.

• entity: Dit blok behandelt Home Assistant-entiteitdomeinen zoals select, sensor, switch, number, time en input. De kaart haalt dynamisch de namen en staten van deze entiteiten op, zoals Zuigniveau of Stil, rechtstreeks uit de integratie om consistentie te waarborgen.

  • Kaartspecifieke staten: Biedt vertalingen voor interne staten die uitsluitend door de UI van de kaart worden gebruikt en niet door Home Assistant-entiteiten. Dit omvat kamernamen (afgeleid van de segment_name-entiteit), samen met specifieke identificatoren zoals task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method en recovery_map_type.

Datum-, tijds- en eenheidsopmaak

Naast tekstvertalingen past de kaart zich automatisch aan lokale opmaakvoorkeuren aan zonder dat handmatige configuratie nodig is:

• Taal en locatie: De kaart geeft prioriteit aan de taal die in het Home Assistant-profiel is geselecteerd. Als daar geen taal expliciet is ingesteld, valt hij automatisch terug op de standaardtaal van de webbrowser.
• 12/24-Uur Tijdformaat: De kaart respecteert het tijdformaat dat is ingesteld in het Home Assistant-profiel. Als dit niet is gespecificeerd, adopteert het automatisch het standaardtijdformaat van de regio van het apparaat.
• Eerste Dag van de Week: De kaart leest de instelling voor de eerste dag van de week rechtstreeks uit Home Assistant. Als dit niet is gedefinieerd, bepaalt het dynamisch of de kalender op zondag of maandag moet beginnen op basis van de lokale regio.
• Eenjheidensysteem: De kaart controleert continu de globale configuratie van Home Assistant. Als het systeem het imperiale eenheidensysteem gebruikt, herberekent de kaart automatisch gebieden en afstanden en toont deze native in voeten, vierkante voeten of yards.
• Vertalingen van native eenheden: Veelvoorkomende eenheidssuffixen en afkortingen, zoals meter, kilometer, voet, yard, minuut en uur, vereisen geen handmatige vertaling. De kaart vertaalt ze onmiddellijk met behulp van ingebouwde browserfuncties die specifiek zijn afgestemd op de actieve taal.

Vertalingen corrigeren of verbeteren

Als een typefout of onjuiste vertaling wordt vastgesteld, of als ondersteuning voor een nieuwe taal nodig is, gaan bijdragen naar de hoofddreame_vacuum integratierepository.

Generalisatie van vertalingen

De officiële app gebruikt vaak verschillende terminologie voor identieke parameters over verschillende apparaatgegeneraties. Vertalingen moeten logische, gegeneraliseerde namen gebruiken in plaats van strikt de exacte bewoordingen uit de APP te kopiëren. Dit voorkomt vertaalconflicten waarbij een correctie die is afgestemd op één specifieke generatie later wordt overschreven door gebruikers met andere apparaatgegeneraties.

Het updateproces omvat de volgende stappen:

1. Fork de Repository: Forken van de Dreame Vacuum Home Assistant integratie repository op GitHub.
2. Vind het Vertaalbestand: Navigeer naar de custom_components/dreame_vacuum/translations/ directory in de geforkte repository om het vertaalbestand te vinden dat overeenkomt met de taalcode, zoals de.json of it.json.
3. Maak de Wijzigingen: Bijwerken van de onjuiste tekst. De frontend_action, frontend_config, frontend_message en frontend_title blokken beheren UI-gerelateerde tekst. Het entity blok beheert sensornamen, selecteeropties en hun toestanden.
4. Dien een Pull Request in: Open een Pull Request naar de hoofdrepository. Nadat de Pull Request is beoordeeld en samengevoegd in een nieuwe release van de integratie, haalt de Dreame Vacuum Card automatisch de bijgewerkte vertalingen op.