Localización

La Tarjeta de Aspiradora Dreame admite de manera nativa múltiples idiomas. Utiliza dinámicamente los archivos de idioma proporcionados por la integración de backend dreame_vacuum en lugar de mantener archivos de localización separados.

La tarjeta obtiene los valores de texto localizados de la sección entity_component dentro de dreame_vacuum archivos de traducción de la integración.

Claves de Traducción

Dentro de los archivos de idioma, la tarjeta utiliza principalmente varias categorías de claves que comienzan con frontend_ para mostrar su interfaz:

• frontend_action: Esta sección contiene todo el texto utilizado dentro de los botones de acción en el panel de control principal de la tarjeta, como Iniciar, Pausar o Acoplar.

• frontend_config: Esta sección contiene todas las etiquetas de texto, descripciones y configuraciones utilizadas dentro de la interfaz visual del configurador de la tarjeta.

• frontend_message: Contiene mensajes de estado, alertas, reportes de errores y advertencias mostradas en la tarjeta.

• frontend_title: Cubre los encabezados y títulos de sección utilizados dentro de los menús de la tarjeta, como Gestión del Mapa o Configuración de Limpieza.

• entity: Este bloque cubre dominios de entidades de Home Assistant, como select, sensor, switch, number, time y input. La tarjeta obtiene dinámicamente los nombres y estados de estas entidades, como Nivel de Succión o Silencioso, directamente de la integración para garantizar coherencia.

  • Estados Específicos de la Tarjeta: Proporciona traducciones para estados internos utilizados exclusivamente por la interfaz de usuario de la tarjeta en lugar de las entidades de Home Assistant. Esto incluye nombres de habitaciones (derivados de la entidad segment_name), junto con identificadores específicos como task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method y recovery_map_type.

Formato de Fecha, Hora y Unidad

Además de las traducciones de texto, la tarjeta se adapta automáticamente a las preferencias de formato locales sin requerir configuración manual:

• Idioma y Configuración Regional: La tarjeta prioriza el idioma seleccionado en el perfil de Home Assistant. Si no se establece un idioma explícitamente allí, automáticamente utiliza el idioma predeterminado del navegador web.
• Formato de hora 12/24: La tarjeta respeta el formato de hora configurado en el perfil de Home Assistant. Si no se especifica, adopta automáticamente el formato de hora estándar de la región del dispositivo.
• Primer día de la semana: La tarjeta lee la configuración del primer día de la semana directamente desde Home Assistant. Si no está definido, determina dinámicamente si el calendario debe comenzar en domingo o lunes según la región local.
• Sistema de unidades: La tarjeta verifica continuamente la configuración global de Home Assistant. Si el sistema utiliza el sistema de unidades imperial, la tarjeta recalcula automáticamente áreas y distancias, mostrándolas de manera nativa en pies, pies cuadrados o yardas.
• Traducciones de Unidades Nativas: Los sufijos y abreviaturas de unidades comunes, como metro, kilómetro, pie, yarda, minuto y hora, no requieren ninguna traducción manual. La tarjeta las traduce automáticamente utilizando funciones incorporadas del navegador diseñadas específicamente para el idioma activo.

Corregir o mejorar traducciones

Si se identifica un error tipográfico o una traducción incorrecta, o se necesita soporte para un nuevo idioma, las contribuciones se envían al repositorio principal de dreame_vacuum integración.

Generalización de Traducción

La aplicación oficial utiliza con frecuencia terminología diferente para parámetros idénticos en varias generaciones de dispositivos. Las traducciones deben emplear nombres lógicos y generalizados en lugar de copiar estrictamente la redacción exacta de la APP. Esto previene conflictos de traducción donde una corrección específica para una generación determinada se sobrescribe posteriormente por usuarios con diferentes generaciones de dispositivos.

El proceso de actualización implica los siguientes pasos:

1. Bifurcar el Repositorio: Bifurcando el repositorio de la integración Dreame Vacuum Home Assistant en GitHub.
2. Encontrar el Archivo de Traducción: Navegando al directorio custom_components/dreame_vacuum/translations/ en el repositorio bifurcado para localizar el archivo de traducción que coincida con el código de idioma, como de.json o it.json.
3. Hacer los Cambios: Actualizando el texto incorrecto. Los bloques frontend_action, frontend_config, frontend_message y frontend_title gestionan el texto relacionado con la interfaz de usuario. El bloque entity gestiona los nombres de los sensores, las opciones de selección y sus estados.
4. Enviar un Pull Request: Abriendo un Pull Request al repositorio principal. Después de que el Pull Request sea revisado y fusionado en una nueva versión de la integración, la Dreame Vacuum Card recoge automáticamente las traducciones actualizadas.