Localização

O Cartão Dreame Vacuum suporta nativamente múltiplos idiomas. Ele utiliza dinamicamente os ficheiros de idioma fornecidos pela integração backend dreame_vacuum em vez de manter ficheiros de localização separados.

O cartão obtém valores de texto localizados da secção entity_component dentro de dreame_vacuum ficheiros de tradução da integração.

Chaves de Tradução

Dentro dos ficheiros de idioma, o cartão utiliza principalmente várias categorias de chaves começando com frontend_ para exibir a sua interface:

• frontend_action: Esta secção contém todo o texto usado dentro dos botões de ação no painel de controlo principal do cartão, como Iniciar, Pausar ou Acoplar.

• frontend_config: Esta secção contém todas as etiquetas de texto, descrições e definições usadas dentro da interface visual do configurador do cartão.

• frontend_message: Contém mensagens de estado, alertas, relatórios de erro e avisos exibidos no cartão.

• frontend_title: Abrange os cabeçalhos e títulos de secções usados nos menus do cartão, como Gestão de Mapas ou Definições de Limpeza.

• entity: Este bloco cobre domínios de entidades do Home Assistant, tais como select, sensor, switch, number, time e input. O cartão obtém dinamicamente os nomes e estados destas entidades, como Nível de Sucção ou Silencioso, diretamente da integração para garantir consistência.

  • Estados Específicos do Cartão: Fornece traduções para estados internos usados exclusivamente na interface do cartão e não nas entidades do Home Assistant. Isto inclui nomes de divisões (derivados da entidade segment_name), juntamente com 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 e recovery_map_type.

Formatação de Data, Hora e Unidade

Além das traduções de texto, o cartão adapta-se automaticamente às preferências locais de formatação sem necessidade de configuração manual:

• Idioma e Localidade: O cartão dá prioridade ao idioma selecionado no perfil do Home Assistant. Se nenhum idioma for definido explicitamente aí, recorre automaticamente ao idioma predefinido do navegador web.
• Formato de Hora 12/24: O cartão respeita o formato de hora configurado no perfil do Home Assistant. Se não for especificado, adota automaticamente o formato de hora padrão da região do dispositivo.
• Primeiro Dia da Semana: O cartão lê a definição do primeiro dia da semana diretamente do Home Assistant. Se não estiver definido, determina dinamicamente se o calendário deve começar no domingo ou na segunda-feira com base na região local.
• Sistema de Unidades: O cartão verifica continuamente a configuração global do Home Assistant. Se o sistema usar o sistema de unidades Imperial, o cartão recalcula automaticamente áreas e distâncias, mostrando-as nativamente em pés, pés quadrados ou jardas.
• Traduções de Unidades Nativas: Sufixos e abreviações comuns de unidades, como metro, quilómetro, pé, jarda, minuto e hora, não requerem qualquer tradução manual. O cartão traduz-nos automaticamente utilizando funcionalidades incorporadas do navegador, especificamente adaptadas à língua ativa.

Corrigir ou Melhorar Traduções

Se for identificado um erro tipográfico ou uma tradução incorreta, ou se houver necessidade de suporte para uma nova língua, as contribuições devem ser feitas para o repositório principal de dreame_vacuum integração.

Generalização da Tradução

A aplicação oficial utiliza frequentemente terminologia diferente para parâmetros idênticos em várias gerações de dispositivos. As traduções devem utilizar nomes lógicos e generalizados em vez de copiar estritamente a formulação exata da APP. Isto previne conflitos de tradução em que uma correção feita para uma geração específica é posteriormente sobrescrita por utilizadores com gerações de dispositivos diferentes.

O processo de atualização envolve os seguintes passos:

1. Crie um Fork do Repositório: Fazendo um fork do repositório da integração Dreame Vacuum Home Assistant no GitHub.
2. Encontre o Ficheiro de Tradução: Navegando até ao diretório custom_components/dreame_vacuum/translations/ no repositório forkado para localizar o ficheiro de tradução correspondente ao código de idioma, tal como de.json ou it.json.
3. Faça as Alterações: Atualizando o texto incorreto. Os blocos frontend_action, frontend_config, frontend_message e frontend_title gerem o texto relacionado com a interface de utilizador. O bloco entity gere os nomes dos sensores, opções de seleção e os seus estados.
4. Submeta um Pull Request: Abrindo um Pull Request para o repositório principal. Após o Pull Request ser revisto e incorporado numa nova versão da integração, a Dreame Vacuum Card irá automaticamente reconhecer as traduções atualizadas.