Localització

La Targeta de l'Aspirador Dreame admet de manera nativa múltiples idiomes. Utilitza de manera dinàmica els fitxers d'idioma proporcionats per la integració del backend dreame_vacuum en lloc de mantenir fitxers de localització separats.

La targeta recupera els valors de text localitzats des de la secció entity_component dins del dreame_vacuum fitxers de traducció de la integració.

Claus de Traducció

Dins dels fitxers d'idioma, la targeta utilitza principalment diverses categories clau començant amb frontend_ per mostrar la seva interfície:

• frontend_action: Aquesta secció conté tot el text utilitzat dins dels botons d'acció al panell de control principal de la targeta, com Iniciar, Pausar o Acoblar.

• frontend_config: Aquesta secció conté totes les etiquetes de text, descripcions i configuracions utilitzades dins de la UI del configurador de targetes visuals.

• frontend_message: Conté missatges d'estat, alertes, informes d'errors i avisos mostrats a la targeta.

• frontend_title: Cobreix els encapçalaments i els títols de secció utilitzats dins dels menús de la targeta, com Gestió del Mapa o Configuració de Neteja.

• entity: Aquest bloc cobreix dominis d'entitats de Home Assistant com select, sensor, switch, number, time i input. La targeta obté dinàmicament els noms i estats d'aquestes entitats, com Nivell de succió o Silenciós, directament de la integració per garantir coherència.

  • Estats específics de la targeta: Proporciona traduccions per als estats interns utilitzats exclusivament per la interfície de la targeta en lloc de les entitats de Home Assistant. Això inclou noms d'habitacions (derivats de l'entitat segment_name), juntament amb identificadors específics com task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method i recovery_map_type.

Format de data, hora i unitats

A més de les traduccions de text, la targeta s'adapta automàticament a les preferències locals de format sense necessitat de configuració manual:

• Idioma i configuració regional: La targeta prioritza l'idioma seleccionat al perfil de Home Assistant. Si no es estableix cap idioma explícitament allà, automàticament fa servir l'idioma per defecte del navegador web.
• Format de 12/24 hores: La targeta respecta el format d'hora configurat al perfil de Home Assistant. Si no s'especifica, adopta automàticament el format d'hora estàndard de la regió del dispositiu.
• Primer dia de la setmana: La targeta llegeix la configuració del primer dia de la setmana directament de Home Assistant. Si no està definit, determina dinàmicament si el calendari ha de començar el diumenge o el dilluns segons la regió local.
• Sistema d'unitats: La targeta comprova contínuament la configuració global de Home Assistant. Si el sistema utilitza el sistema d'unitats imperial, la targeta recalcula automàticament les àrees i distàncies, mostrant-les de manera nativa en peus, peus quadrats o iardes.
• Traduccions d'Unitats natives: Els sufixos i abreviatures d'unitats comuns, com ara metre, quilòmetre, peu, iac, minut i hora, no requereixen cap traducció manual. La targeta les tradueix a l'instant utilitzant característiques integrades del navegador dissenyades específicament per a l'idioma actiu.

Arreglar o Millorar Traduccions

Si s'identifica un error tipogràfic o una traducció incorrecta, o si es necessita suport per a un nou idioma, les contribucions es dirigiran al repositori principal d'integració dreame_vacuum.

Generalització de la traducció

L'aplicació oficial utilitza freqüentment terminologia diferent per a paràmetres idèntics a través de diverses generacions de dispositius. Les traduccions han d'utilitzar noms lògics i generalitzats en lloc de copiar estrictament la redacció exacta de l'APP. Això evita conflictes de traducció on una correcció feta per a una generació específica pot ser posteriorment sobreescrita per usuaris amb generacions de dispositius diferents.

El procés d'actualització implica els passos següents:

1. Bifurca el Repositori: Bifurcant el repositori de la integració Dreame Vacuum Home Assistant a GitHub.
2. Troba el Fitxer de Traducció: Navegant al directori custom_components/dreame_vacuum/translations/ al repositori bifurcat per localitzar el fitxer de traducció que coincideixi amb el codi de llengua, com de.json o it.json.
3. Fes els Canvis: Actualitzant el text incorrecte. Els blocs frontend_action, frontend_config, frontend_message i frontend_title gestionen el text relacionat amb la interfície d'usuari. El bloc entity gestiona els noms dels sensors, les opcions de selecció i els seus estats.
4. Envia una Pull Request: Obrint una Pull Request al repositori principal. Després que la Pull Request sigui revisada i fusionada en una nova versió de la integració, la Dreame Vacuum Card recull automàticament les traduccions actualitzades.