Localisation

La carte Dreame Vacuum prend en charge nativement plusieurs langues. Elle utilise dynamiquement les fichiers de langue fournis par l'intégration backend dreame_vacuum plutôt que de maintenir des fichiers de localisation séparés.

La carte récupère les valeurs de texte localisées à partir de la section entity_component dans le dreame_vacuum fichiers de traduction d'intégration.

Clés de traduction

Dans les fichiers de langue, la carte utilise principalement plusieurs catégories de clés commençant par frontend_ pour afficher son interface :

• frontend_action : Cette section contient tous les textes utilisés à l'intérieur des boutons d'action du panneau de contrôle principal de la carte, tels que Démarrer, Pause ou Retour à la base.

• frontend_config: Cette section contient tous les libellés de texte, descriptions et paramètres utilisés dans l'interface de configuration visuelle de la carte.

• frontend_message: Contient les messages d'état, alertes, rapports d'erreurs et avertissements affichés sur la carte.

• frontend_title : Couvre les en-têtes et titres de section utilisés dans les menus de la carte, tels que Gestion de la carte ou Paramètres de nettoyage.

• entity : Ce bloc couvre les domaines d'entités de Home Assistant tels que select, sensor, switch, number, time et input. La carte récupère dynamiquement les noms et les états de ces entités, tels que Niveau d'aspiration ou Silencieux, directement depuis l'intégration pour garantir la cohérence.

  • États spécifiques à la carte : Fournit des traductions pour les états internes utilisés exclusivement par l'interface de la carte plutôt que par les entités de Home Assistant. Cela inclut les noms de chambres (dérivés de l'entité segment_name), ainsi que des identifiants spécifiques tels que task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method et recovery_map_type.

Formatage de la date, de l'heure et des unités

En plus des traductions de texte, la carte s'adapte automatiquement aux préférences de formatage locales sans nécessiter de configuration manuelle :

• Langue et région : La carte privilégie la langue sélectionnée dans le profil Home Assistant. Si aucune langue n'est explicitement définie, elle se rabat automatiquement sur la langue par défaut du navigateur web.
• Format de l'heure 12/24h : La carte respecte le format de l'heure configuré dans le profil Home Assistant. Si non spécifié, elle adopte automatiquement le format horaire standard de la région de l'appareil.
• Premier jour de la semaine : La carte lit directement le paramètre du premier jour de la semaine à partir de Home Assistant. S'il n'est pas défini, elle détermine dynamiquement si le calendrier doit commencer le dimanche ou le lundi en fonction de la région locale.
• Système d'unités : La carte vérifie en continu la configuration globale de Home Assistant. Si le système utilise le système impérial, la carte recalcule automatiquement les surfaces et distances, les affichant nativement en pieds, pieds carrés ou yards.
• Traductions d'unités natives : Les suffixes et abréviations d'unités courants, tels que mètre, kilomètre, pied, yard, minute et heure, ne nécessitent aucune traduction manuelle. La carte les traduit automatiquement à l'aide des fonctionnalités intégrées du navigateur adaptées spécifiquement à la langue active.

Corriger ou améliorer les traductions

Si une faute de frappe ou une traduction incorrecte est identifiée, ou si un support pour une nouvelle langue est nécessaire, les contributions sont envoyées au dépôt principal d'intégration dreame_vacuum.

Généralisation de la traduction

L'application officielle utilise fréquemment une terminologie différente pour des paramètres identiques à travers diverses générations d'appareils. Les traductions doivent utiliser des noms logiques et généralisés plutôt que de copier strictement le libellé exact de l'APP. Cela permet d'éviter les conflits de traduction où une correction adaptée à une génération spécifique est ensuite écrasée par les utilisateurs d'autres générations d'appareils.

Le processus de mise à jour comprend les étapes suivantes :

1. Forker le dépôt : Forker le dépôt de l'intégration Dreame Vacuum Home Assistant sur GitHub.
2. Trouver le fichier de traduction : Naviguer vers le répertoire custom_components/dreame_vacuum/translations/ dans le dépôt forké pour localiser le fichier de traduction correspondant au code de langue, comme de.json ou it.json.
3. Effectuer les modifications : Mettre à jour le texte incorrect. Les blocs frontend_action, frontend_config, frontend_message et frontend_title gèrent le texte lié à l'interface utilisateur. Le bloc entity gère les noms des capteurs, les options de sélection et leurs états.
4. Soumettre une Pull Request : Ouvrir une Pull Request vers le dépôt principal. Après que la Pull Request est examinée et fusionnée dans une nouvelle version de l'intégration, la Dreame Vacuum Card récupère automatiquement les traductions mises à jour.