Perguntas Frequentes

Esta página reúne perguntas frequentes, etapas comuns de solução de problemas e exemplos práticos de configuração para o Cartão de Aspirador Dreame. Ela fornece soluções para problemas generalizados, juntamente com técnicas avançadas de layout e estilo que combinam várias opções de configuração.

Por que aparece o erro "Falha ao carregar o cartão"?

Mostrar Resposta

Esse erro geralmente indica um problema de cache ou uma instalação incompleta. Atualizar a página do navegador enquanto se limpa o cache resolve o problema na maioria dos casos. Se o problema persistir, é recomendada a reinstalação da versão atual da integração. O guia Instalação Manual fornece instruções detalhadas para este processo. Se o cartão ainda falhar ao carregar após essas etapas, é necessário abrir um relatório de bug. A página Relatório de Problemas explica como coletar os logs necessários.

Como corrigir traduções incorretas ou ausentes?

Mostrar Resposta

O cartão utiliza dinamicamente os arquivos de idioma fornecidos pela integração do backend. Terminologia incorreta ou traduções ausentes exigem atualizações no repositório principal da integração. A seção Corrigir ou Melhorar Traduções na página de Localização detalha os passos exatos para enviar correções de tradução.

Como o cartão pode ser exibido em tela cheia?

Mostrar Resposta

Para a melhor experiência do usuário em tablets e monitores de desktop, o cartão suporta a visualização de painel nativa do Home Assistant. A seção Usando o Modo Painel no guia de Instalação e Uso detalha os passos para configurar uma visualização do painel onde um único cartão ocupa toda a tela.

Como as cores dos cômodos no mapa podem ser personalizadas?

Mostrar Resposta

O cartão permite uma personalização extensiva da aparência visual do mapa. A seção Substituindo Cores no guia de Configuração Avançada explica como definir cores personalizadas para cômodos individuais, fundos e outros elementos do mapa.

Por que o cartão não aumenta além do tamanho da tela?

Mostrar Resposta

Por design, o cartão restringe sua altura máxima para garantir que ele se ajuste totalmente dentro da área visível da tela sem exigir rolagem vertical. Configurar a opção Altura total para false na Configuração Avançada substitui esse comportamento, permitindo que o cartão se redimensione para a largura máxima disponível, mesmo que ultrapasse os limites da tela.

Como o mapa pode ser permanentemente bloqueado para dashboards de tablets montados na parede?

Mostrar Resposta

Quando o dashboard é exibido em um painel de parede sensível ao toque, a movimentação acidental do mapa pode ser evitada configurando o Modo de Bloqueio do Cartão na Configuração Básica para Sempre. Essa configuração força o mapa a permanecer completamente estático, ignorando movimentos ou rolagens acidentais, mantendo os botões de ação totalmente acessíveis.

Como o fundo do cartão pode ser tornado completamente transparente?

Mostrar Resposta

O cartão segue inerentemente o tema do Home Assistant, mas seu plano de fundo pode ser totalmente transparente para se misturar perfeitamente aos planos de fundo personalizados do dashboard. A seção Substituindo Cores no guia de Configuração Avançada explica como definir explicitamente as propriedades map_background e card_background para transparent.

Como o cartão pode ser integrado a um plano de piso existente?

Mostrar Resposta

O cartão detecta automaticamente quando é colocado dentro de um cartão Picture Glance e adapta seu layout. Definir a opção Objetos ocultos para All remove todos os elementos da interface do usuário, deixando apenas o mapa visível. Além disso, elementos específicos do mapa podem ser ocultados usando a opção Objetos de mapa ocultos, permitindo que o mapa se misture perfeitamente com uma imagem personalizada do plano de piso. O Configuração Personalizada do Mapa fornece opções adicionais para ajustar finamente o nível de zoom e a posição do mapa para alinhar perfeitamente com o plano de fundo.

Como uma imagem personalizada do plano de piso pode ser exibida em vez do mapa escaneado?

Mostrar Resposta

Para dispositivos não suportados ou dashboards personalizados, uma imagem estática pode ser sobreposta no cartão. O Configuração Personalizada do Mapa fornece opções background_image e overlay_image que podem ser alinhadas usando coordenadas exatas. O mapa digitalizado original pode então ser totalmente oculto definindo a propriedade Exibição do mapa para Somente Planta, deixando apenas a imagem personalizada e a posição ao vivo do robô visíveis no cartão.

Como scripts personalizados do Home Assistant podem ser acionados diretamente a partir do cartão?

Mostrar Resposta

O cartão integra-se nativamente com scripts personalizados. Ao defini-los na seção Scripts da Configuração Avançada, o cartão automaticamente popula o botão de ação Atalhos com esses scripts personalizados do Home Assistant, substituindo completamente os atalhos nativos do dispositivo na tela inicial.

Por que o cartão funciona apenas como uma pré-visualização limitada?

Mostrar Resposta

A interface funciona apenas como uma visualização limitada até que uma chave de licença seja validamente verificada de forma segura. Ativar o cartão desbloqueia todos os recursos interativos do mapa, controle das configurações do dispositivo e sequências de limpeza personalizadas.

Onde a chave de licença comprada pode ser encontrada?

Mostrar Resposta

Uma transação bem-sucedida exibe a chave de licença única diretamente na tela de confirmação para cópia imediata. Cada chave de licença comprada permanece acessível a qualquer momento no portal seguro para clientes do provedor de pagamento. Um endereço de e-mail usado em uma compra anterior leva a uma etapa de verificação durante o checkout. Um código de uso único é enviado para esse endereço, e ao enviar o código, se abre o mesmo portal do cliente listando todas as chaves de licença na conta.

Como a chave de licença comprada é ativada?

Mostrar Resposta

Após obter uma chave de licença, é necessário configurar o cartão para utilizá-la. A seção Ativação dentro do Cartão fornece instruções passo a passo sobre como adicionar o cartão ao painel, acessar o menu de configuração do dispositivo e inserir a chave de licença com segurança para desbloquear todos os recursos.

Uma única chave de licença pode ser usada para vários dispositivos de aspiração?

Mostrar Resposta

Não. O modelo de licença específico para dispositivo requer chaves de licença individuais para múltiplos aspiradores. Cada chave de licença ativa permanentemente o cartão para um único dispositivo de aspiração. Adquirir uma licença para um dispositivo adicional financia diretamente o esforço contínuo de desenvolvimento necessário para integrar e suportar novos modelos de hardware.