Localizzazione

La Scheda Dreame Vacuum supporta nativamente più lingue. Utilizza dinamicamente i file di lingua forniti dall'integrazione backend dreame_vacuum invece di mantenere file di localizzazione separati.

La scheda recupera i valori di testo localizzati dalla sezione entity_component all'interno del dreame_vacuum file di traduzione dell'integrazione.

Chiavi di Traduzione

All'interno dei file di lingua, la scheda utilizza principalmente diverse categorie di chiavi che iniziano con frontend_ per visualizzare la sua interfaccia:

• frontend_action: Questa sezione contiene tutto il testo utilizzato all'interno dei pulsanti di azione sul pannello di controllo principale della scheda, come Avvia, Pausa o Ricarica.

• frontend_config: Questa sezione contiene tutte le etichette di testo, descrizioni e impostazioni utilizzate all'interno dell'interfaccia di configurazione visiva della scheda.

• frontend_message: Contiene messaggi di stato, avvisi, rapporti di errore e notifiche visualizzati sulla scheda.

• frontend_title: Copre i titoli e le intestazioni delle sezioni utilizzati all'interno dei menu della scheda, come Gestione Mappe o Impostazioni di Pulizia.

• entity: Questo blocco copre domini di entità di Home Assistant come select, sensor, switch, number, time e input. La scheda estrae dinamicamente i nomi e gli stati di queste entità, come Livello di aspirazione o Silenzioso, direttamente dall’integrazione per garantire coerenza.

  • Stati specifici della scheda: Fornisce traduzioni per gli stati interni utilizzati esclusivamente dall'interfaccia della scheda, piuttosto che dalle entità di Home Assistant. Questo include i nomi delle stanze (derivati dall’entità segment_name), insieme a identificatori specifici come task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method e recovery_map_type.

Formattazione di data, ora e unità

Oltre alle traduzioni del testo, la scheda si adatta automaticamente alle preferenze locali di formattazione senza richiedere alcuna configurazione manuale:

• Lingua e localizzazione: La scheda dà priorità alla lingua selezionata nel profilo di Home Assistant. Se non è impostata esplicitamente alcuna lingua, utilizza automaticamente la lingua predefinita del browser web.
• Formato orario 12/24 ore: La scheda rispetta il formato orario configurato nel profilo di Home Assistant. Se non specificato, adotta automaticamente il formato orario standard della regione del dispositivo.
• Primo giorno della settimana: La scheda legge direttamente l'impostazione del primo giorno della settimana da Home Assistant. Se non definito, determina dinamicamente se il calendario deve iniziare di domenica o di lunedì in base alla regione locale.
• Sistema di unità: La scheda controlla continuamente la configurazione globale di Home Assistant. Se il sistema utilizza il sistema di unità imperiale, la scheda ricalcola automaticamente aree e distanze, visualizzandole nativamente in piedi, piedi quadrati o yard.
• Traduzioni delle unità native: Suffissi e abbreviazioni comuni delle unità, come metro, chilometro, piede, iarda, minuto e ora, non richiedono alcuna traduzione manuale. La scheda le traduce automaticamente utilizzando le funzionalità integrate del browser, specificamente progettate per la lingua attiva.

Correggi o migliora le traduzioni

Se viene identificato un errore di battitura o una traduzione errata, oppure se è necessario il supporto per una nuova lingua, i contributi vanno al principale repository di integrazione dreame_vacuum.

Generalizzazione della traduzione

L'app ufficiale utilizza frequentemente terminologie diverse per parametri identici tra varie generazioni di dispositivi. Le traduzioni devono usare nomi logici e generalizzati piuttosto che copiare rigidamente la formulazione esatta dall'APP. Ciò previene conflitti di traduzione in cui una correzione destinata a una specifica generazione viene successivamente sovrascritta da utenti con generazioni di dispositivi diverse.

Il processo di aggiornamento prevede i seguenti passaggi:

1. Fai il Fork del Repository: Fare il fork del repository dell'integrazione Dreame Vacuum Home Assistant su GitHub.
2. Trova il File di Traduzione: Navigare nella directory custom_components/dreame_vacuum/translations/ nel repository forkato per trovare il file di traduzione corrispondente al codice lingua, come de.json o it.json.
3. Apporta le Modifiche: Aggiornare il testo errato. I blocchi frontend_action, frontend_config, frontend_message e frontend_title gestiscono il testo relativo all'interfaccia utente. Il blocco entity gestisce i nomi dei sensori, le opzioni di selezione e i loro stati.
4. Invia una Pull Request: Aprire una Pull Request verso il repository principale. Dopo che la Pull Request è stata revisionata e unita in una nuova versione dell'integrazione, Dreame Vacuum Card acquisirà automaticamente le traduzioni aggiornate.