Localização

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

O cartão recupera valores de texto localizados da seção entity_component dentro do dreame_vacuum arquivos de tradução da integração.

Chaves de Tradução

Dentro dos arquivos de idioma, o cartão usa principalmente várias categorias de chave começando com frontend_ para exibir sua interface:

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

• frontend_config: Esta seção contém todos os rótulos de texto, descrições e configurações usados dentro da interface do configurador visual do cartão.

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

• frontend_title: Abrange os títulos e capítulos usados nos menus do cartão, como Gerenciamento de Mapas ou Configurações de Limpeza.

• entity: Este bloco cobre domínios de entidades do Home Assistant, como select, sensor, switch, number, time e input. O cartão puxa dinamicamente os nomes e estados dessas 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 pela interface do cartão, e não por entidades do Home Assistant. Isso inclui nomes de cômodos (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 se adapta automaticamente às preferências de formatação locais sem exigir qualquer configuração manual:

• Idioma e Localidade: O cartão prioriza o idioma selecionado no perfil do Home Assistant. Se nenhum idioma estiver explicitamente definido, ele automaticamente utiliza o idioma padrão do navegador web.
• Formato de Hora 12/24 Horas: O cartão respeita o formato de hora configurado no perfil do Home Assistant. Se não especificado, ele adota automaticamente o formato de hora padrão da região do dispositivo.
• Primeiro Dia da Semana: O cartão lê a configuração do primeiro dia da semana diretamente do Home Assistant. Se não definido, ele 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, exibindo-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 exigem tradução manual. O cartão os traduz automaticamente usando recursos integrados do navegador, adaptados especificamente ao idioma ativo.

Corrigir ou Melhorar Traduções

Se um erro de digitação ou tradução incorreta for identificado, ou se houver necessidade de suporte a um novo idioma, as contribuições vão para o repositório principal de dreame_vacuum integração.

Generalização da Tradução

O aplicativo oficial frequentemente usa 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 simplesmente copiar as palavras exatas do APP. Isso evita conflitos de tradução, onde uma correção feita para uma geração específica é posteriormente sobrescrita por usuários de gerações de dispositivos diferentes.

O processo de atualização envolve as seguintes etapas:

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 Arquivo de Tradução: Navegando até o diretório custom_components/dreame_vacuum/translations/ no repositório forked para localizar o arquivo de tradução que corresponda ao código do idioma, 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 gerenciam o texto relacionado à interface de usuário. O bloco entity gerencia nomes de sensores, opções de seleção e seus estados.
4. Envie um Pull Request: Abrindo um Pull Request para o repositório principal. Após o Pull Request ser revisado e mesclado em uma nova versão da integração, o Dreame Vacuum Card automaticamente adota as traduções atualizadas.