Configuração

Esta seção cobre as opções fundamentais para colocar o Cartão do Aspirador Dreame em funcionamento. Ela detalha como conectar a entidade do aspirador e personalizar as configurações visuais e de interação principais.

Configuração Mínima (entity)

O cartão requer apenas o parâmetro entity para funcionar e nenhuma outra configuração é necessária. Isso define a entidade principal do Home Assistant para o aspirador, que deve pertencer à integração dreame_vacuum, como vacuum.l10s_gen2. Ele irá detectar automaticamente as capacidades do dispositivo com base apenas neste parâmetro.

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2

Configuração Básica

Os seguintes parâmetros podem ser usados para alterar o estilo visual e os modos de interação do mapa.

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
title: First Floor Vacuum
color_scheme: dreame_auto
icon_set: material
map_display: floor_plan
locked: only_touch

Título (title)

Um título customizado opcional para o topo do cartão. Por padrão, ele utiliza o nome amigável do dispositivo do Home Assistant.

Ocultando o Título

Se desejado, o título do cartão pode ser completamente desativado usando o parâmetro de configuração hidden_card_objects. Quando o título está oculto, o estado atual do aspirador será exibido em seu lugar no topo do cartão.

Esquema de Cores do Mapa (color_scheme)

Define a paleta de cores aplicada a vários elementos no mapa, como salas, caminhos e paredes.

Valor Padrão

Se este parâmetro não for fornecido na configuração, ele usa por padrão o esquema de cores selecionado nas configurações da integração.

• Dreame Claro (dreame_light): Tema oficial do aplicativo Dreame.
• Dreame Escuro (dreame_dark): Tema escuro exclusivo da integração dreame_vacuum.
• Dreame Automático (dreame_auto): Alterna automaticamente entre dreame_light e dreame_dark com base no tema do sistema.
• Mijia Claro (mijia_light): Tema claro oficial do aplicativo Xiaomi Mi Home.
• Mijia Escuro (mijia_dark): Tema escuro oficial do aplicativo Xiaomi Mi Home.
• Mijia Automático (mijia_auto): Alterna automaticamente entre mijia_light e mijia_dark com base no tema do sistema.
• Escala de Cinza (grayscale): Um tema de mapa monocromático sem cores.

Substituindo Cores

Se os esquemas de cores predefinidos não atenderem às suas necessidades, as cores individuais podem ser totalmente personalizadas usando o parâmetro de configuração override_colors.

Conjunto de Ícones do Mapa (icon_set)

Controla o estilo estético dos ícones exibidos diretamente na superfície do mapa, incluindo os ícones de carregador e de cômodo.

Valor Padrão

Se este parâmetro não for fornecido na configuração, o padrão será o conjunto de ícones selecionado nas configurações da integração.

• Dreame (dreame): Conjunto de ícones do aplicativo oficial Dreame.
• Dreame Old (dreame_old): Conjunto de ícones do aplicativo Dreame legado.
• Mijia (mijia): Conjunto de ícones do aplicativo oficial Xiaomi Mi Home.
• Material (material): Ícones Material Design integrados do HA.

Ocultando Ícones

Se os conjuntos de ícones disponíveis não forem adequados às suas preferências visuais, a visibilidade de ícones específicos no mapa pode ser completamente desativada usando o parâmetro de configuração hidden_objects.

Exibição do Mapa (map_display)

Controla o estilo de exibição do mapa, determinando a visibilidade do mapa escaneado pelo robô, das paredes físicas editáveis e das texturas do piso.

Apenas disponível em dispositivos compatíveis

Os modos de exibição Planta do Andar estão disponíveis apenas para dispositivos que suportam o Display de Mapa 3D v2 ou superior no aplicativo oficial. Em dispositivos mais antigos que não suportam esse recurso, essas propriedades de configuração específicas são desativadas ou não têm efeito, já que os dados do mapa não conterão informações de paredes e portas para serem exibidas.

Para dispositivos não compatíveis, é altamente recomendado usar o parâmetro de configuração Imagem de fundo para alcançar um efeito visual semelhante de planta do andar em 2D ou 3D.

Padrão (standard)

Exibe a vista exata do mapa conforme escaneado pelo robô.

Planta do Andar (floor_plan)

Combina a vista do mapa escaneado pelo robô com a exibição de paredes físicas editáveis.

Planta do Andar Sem Textura (floor_plan_without_texture)

Idêntico a floor_plan, mas oculta a textura das áreas não escaneadas dentro das paredes e exibe todo o material do piso da sala.

Apenas Planta do Andar (floor_plan_only)

Idêntico a floor_plan_without_texture, mas oculta completamente a visualização do mapa escaneado, exibindo apenas as paredes e o piso interno. Esta visualização é altamente útil para cortar e centralizar o mapa automaticamente.

Pré-visualização

Padrão

Planta baixa

Planta baixa sem textura

Apenas planta baixa

Paredes Editáveis

As paredes físicas e limites exibidos nos modos Plano de Piso são totalmente editáveis. Para obter mais detalhes sobre como ajustá-los, consulte a seção Paredes em Gerenciamento de Mapas.

Modo de Bloqueio de Cartão (locked)

Esta configuração é usada para bloquear o movimento e o zoom do mapa dentro do cartão. Ela impede que o mapa se mova e bloqueie a rolagem da página ao navegar pelo painel usando toque ou roda do mouse. O valor inicial é auto. Este mecanismo pode ser configurado de acordo com as seguintes opções:

Redefinição e Bloqueio do Mapa

Sempre que o mapa não estiver em sua posição inicial de reinicialização, o cartão permanece completamente desbloqueado, independentemente do modo de bloqueio definido. Para bloquear o mapa novamente, é necessário realizar um clique duplo ou toque duplo para retornar o mapa à sua visão inicial.

Além disso, independentemente do modo de bloqueio configurado, o mapa sempre pode ser desbloqueado clicando ou tocando duas vezes em um cômodo específico para dar zoom.

Automático (auto)

O cartão detecta se está localizado dentro de um controle rolável e bloqueia o mapa dinamicamente de acordo.

• Interações com o Mouse: O mapa permanece bloqueado até que o mouse seja movimentado ativamente sobre o cartão. Se o mouse pousar no mapa durante a rolagem da página, mas não for movido, o mapa permanece bloqueado. Quando a visualização do mapa é reiniciada via clique duplo, o mapa se bloqueia imediatamente novamente, permitindo que a página seja rolada logo após a reinicialização, desde que o mouse não seja movido.
• Interações por Toque: O mapa está inicialmente bloqueado. Desbloquear o mapa requer uma ação de toque e segure, onde o tempo necessário de retenção é definido pela configuração touch_lock. Um deslizar imediato fará a página do painel rolar, enquanto segurar brevemente desbloqueia o mapa para panorâmica e exibe um indicador. Além disso, realizar uma panorâmica com dois dedos, um zoom com dois dedos ou um toque duplo para zoom desbloqueará instantaneamente o mapa. Uma vez desbloqueado por qualquer um desses métodos de toque, o mapa permanecerá desbloqueado até que a visualização seja redefinida com um toque duplo.

Apenas Toque (only_touch)

O mapa bloqueia exclusivamente durante a panorâmica de toque único, permitindo rolagem irrestrita com a roda do mouse. Uma panorâmica ou zoom com dois dedos desbloqueia o mapa até que a visualização seja redefinida com um toque duplo, tornando este modo recomendado quando a panorâmica frequente não é necessária.

Nunca (never)

O mapa nunca é bloqueado e a rolagem da página está sempre bloqueada.

Sempre (always)

O mapa está bloqueado em todas as áreas. Embora o zoom e o movimento manuais estejam inicialmente desativados, o zoom por toque duplo ou clique duplo continua disponível. Uma vez aumentado o zoom por toque duplo ou clique duplo, o mapa se torna desbloqueado para movimentação até que a visualização seja redefinida com outro toque duplo ou clique duplo.