Configuração

Esta seção cobre as opções fundamentais para colocar o Cartão do Aspirador Dreame a funcionar. Explica como conectar a entidade do aspirador e personalizar as principais definições visuais e de interação.

Configuração Mínima (entity)

O cartão apenas requer o parâmetro entity para funcionar e nenhuma outra configuração é necessária. Este define a entidade principal do Home Assistant para o aspirador, que deve pertencer à integração dreame_vacuum, como vacuum.l10s_gen2. Detectará automaticamente as capacidades do dispositivo com base neste único 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 personalizado opcional para o topo do cartão. Por defeito, utiliza o nome amigável do dispositivo do Home Assistant.

Ocultar o Título

Caso 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, será utilizado o esquema de cores selecionado nas definições da integração.

• Dreame Claro (dreame_light): Tema oficial da aplicação 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 da aplicação Xiaomi Mi Home.
• Mijia Escuro (mijia_dark): Tema escuro oficial da aplicação Xiaomi Mi Home.
• Mijia Automático (mijia_auto): Alterna automaticamente entre mijia_light e mijia_dark com base no tema do sistema.
• Escala de Cinzentos (grayscale): Um tema de mapa monocromático, sem cores.

Sobrescrever 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 do carregador e das divisões.

Valor Padrão

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

• Dreame (dreame): Conjunto de ícones da app oficial Dreame.
• Dreame Old (dreame_old): Conjunto de ícones da app Dreame antiga.
• Mijia (mijia): Conjunto de ícones da app oficial Xiaomi Mi Home.
• Material (material): Ícones Material Design incorporados no HA.

Ocultar Ícones

Se os conjuntos de ícones disponíveis não corresponderem às suas preferências visuais, a visibilidade de ícones específicos no mapa pode ser completamente desativada utilizando 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 digitalizado pelo robô, das paredes físicas editáveis e das texturas do chão.

Apenas disponível em dispositivos suportados

Os modos de exibição Planta do Piso estão estritamente disponíveis para dispositivos que suportam a Exibição de Mapa 3D v2 ou superior na App oficial. Em dispositivos mais antigos que não suportam esta funcionalidade, estas propriedades de configuração específicas estão desativadas ou não têm efeito, uma vez que os dados do mapa não conterão informações de paredes e portas que possam ser exibidas.

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

Padrão (standard)

Exibe a vista exata do mapa conforme foi digitalizada pelo robot.

Planta do Piso (floor_plan)

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

Planta do Piso Sem Textura (floor_plan_without_texture)

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

Apenas Planta do Piso (floor_plan_only)

Idêntico a floor_plan_without_texture, mas esconde completamente a vista do mapa digitalizado, mostrando apenas as paredes e o chão interior. Esta vista é muito ú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 Planta são totalmente editáveis. Para mais detalhes sobre como ajustá-los, consulte a seção Paredes em Gestão de Mapas.

Modo de Bloqueio do Cartão (locked)

Esta configuração é usada para bloquear a panorâmica e o zoom do mapa dentro do cartão. Impede que o mapa seja movido e bloqueie a rolagem da página ao percorrer o painel usando toque ou roleta do rato. O valor inicial é auto. Este mecanismo pode ser configurado de acordo com as seguintes opções:

Redefinir e Bloquear Mapa

Sempre que o mapa não estiver na sua posição inicial de reposição, o cartão permanece completamente desbloqueado, independentemente do modo de bloqueio definido. Para bloquear o mapa novamente, deve ser realizado um duplo clique ou duplo toque para retornar o mapa à sua vista inicial.

Além disso, independentemente do modo de bloqueio configurado, o mapa pode sempre ser desbloqueado ao clicar duas vezes ou tocar duas vezes numa sala específica para ampliar.

Auto (auto)

O cartão detecta se se encontra dentro de um controlo deslizável e bloqueia o mapa dinamicamente em conformidade.

• Interações com o Mouse: O mapa permanece bloqueado até que o mouse seja movido ativamente enquanto estiver sobre o cartão. Se o mouse pousar no mapa durante o scroll da página mas não for movido, o mapa permanece bloqueado. Quando a vista do mapa é reiniciada através de um duplo clique, o mapa bloqueia imediatamente novamente, permitindo que a página seja rolada logo após a reposiçã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 manter, onde o tempo de manutenção necessário é definido pela configuração touch_lock. Um deslize imediato irá percorrer a página do painel, enquanto manter brevemente desbloqueia o mapa para arrastar e exibe um indicador. Além disso, realizar um arrasto com dois dedos, um zoom com dois dedos ou um zoom por duplo toque desbloqueará instantaneamente o mapa. Uma vez desbloqueado através de qualquer um destes métodos de toque, o mapa permanece desbloqueado até que a visualização seja redefinida com um duplo toque.

Apenas Toque (only_touch)

O mapa bloqueia exclusivamente durante o arrasto com um único toque, permitindo a rolagem irrestrita com a roda do rato. Um arrasto ou zoom com dois dedos desbloqueia o mapa até que a visualização seja redefinida com um duplo toque, tornando este modo recomendado quando o arrasto frequente não é necessário.

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 a ampliação e o deslocamento manuais estejam inicialmente desativados, a ampliação com duplo toque ou duplo clique continua disponível. Depois de ampliar através de um duplo toque ou duplo clique, o mapa torna-se desbloqueado para deslocamento até que a vista seja reiniciada com outro duplo toque ou duplo clique.