Instalação e Uso

Este guia explica como colocar o Dreame Vacuum Card funcionando no painel do Home Assistant. Ele cobre os pré-requisitos para a integração, passos para adicionar o cartão aos painéis existentes e instruções para configurar o Modo Painel recomendado. O Modo Painel oferece a melhor experiência possível ao utilizar a tela inteira, sendo especialmente eficiente em tablets e monitores de mesa.

---

O Dreame Vacuum Card está fortemente integrado como parte central do Integração do Dreame Vacuum com Home Assistant. Ele não é um cartão independente que é instalado separadamente.

Para usar este cartão, a dreame_vacuumversão da integração v2.0.0 ou superior, que inclui o cartão incorporado, deve estar instalada.

Pré-requisito

Se a integração Dreame Vacuum já estiver instalada, esta etapa pode ser ignorada com segurança.

Se ainda não estiver instalado, a maneira mais fácil de obtê-lo é através do HACS. A integração Dreame Vacuum pode ser pesquisada em HACS > Integrações e a versão v2.0.0 ou superior pode ser baixada. O Home Assistant deve ser reiniciado após o download. Uma vez que a integração esteja configurada, o cartão estará automaticamente disponível nos dashboards.

Otimização de Entidades

O cartão foi projetado para operar usando apenas as entidades vacuum, sensor.cleaning_history, sensor.cruising_history e camera.map. Ele obtém tudo o que precisa diretamente dessas quatro entidades principais. Como resultado, todas as outras entidades da página do dispositivo, incluindo as entidades de mapa salvas, podem ser desativadas com segurança para manter o Home Assistant limpo.

Para reduzir ainda mais a carga na instância do Home Assistant desativando a geração de imagens do lado do servidor, a entidade camera.map pode ser desabilitada e a entidade camera.map_data habilitada em seu lugar. O cartão detectará isso automaticamente e exibirá todos os mapas diretamente no navegador. No mínimo, o cartão pode funcionar apenas com a entidade vacuum habilitada. Embora o mapa não seja desenhado nesse estado, todos os recursos não relacionados ao mapa, como configurações de limpeza, ações de doca e controles básicos, permanecerão totalmente acessíveis e utilizáveis.

Adicionando o Cartão ao Seu Dashboard

Para adicionar o Cartão de Aspirador Dreame ao dashboard do Home Assistant:

1. O Home Assistant é aberto e o dashboard desejado é acessado.
2. O ícone Editar Dashboard () no canto superior direito é clicado.
3. O botão Adicionar Cartão () no canto inferior direito é clicado.
4. No seletor de cartões, Custom: Cartão de Aspirador Dreame é pesquisado e selecionado.
5. No editor de cartões, a Dreame Vacuum Entity, como vacuum.l10s_gen2, é selecionada.
6. Salvar é clicado para adicionar o cartão ao painel.

Usando o Modo Painel (Recomendado)

Para a melhor experiência do usuário, especialmente considerando o extenso editor de mapas e os recursos do Dreame Vacuum Card, o uso do Modo Painel do Home Assistant é altamente recomendado. O Modo Painel permite que um único cartão ocupe toda a tela de uma vista de painel.

de Limpeza O cartão detecta automaticamente quando é colocado em uma visualização de painel e remove sua cor de fundo e bordas externas para se integrar perfeitamente ao tema do painel. Além disso, todos os elementos internos da interface são totalmente conscientes do painel e adaptam seus layouts para aproveitar o espaço expandido da tela.

Configuração da Vista do Painel de Cartão Único

1. O painel desejado é aberto e o ícone Editar Painel () no canto superior direito é clicado.
2. O ícone Adicionar Visualização () ao lado das abas de visualização do painel no topo é clicado.
3. Na caixa de diálogo "Adicionar Visualização", Painel, a opção de cartão único, é selecionada no dropdown Layout.
4. Um Título opcional, como "Aspirador", e um Ícone, como mdi:robot-vacuum, são fornecidos.
5. Salvar é clicado.
6. O botão Adicionar Cartão () no canto inferior direito é clicado.
7. No seletor de cartões, Custom: Cartão de Aspirador Dreame é pesquisado e selecionado.
8. No editor de cartões, a Dreame Vacuum Entity, como vacuum.l10s_gen2, é selecionada.
9. Salvar é clicado para adicionar o cartão ao painel.

Navegação Nativa do Navegador

Quando usado no Modo Painel ou quando é o único cartão em uma visualização, o cartão lida nativamente com a navegação do navegador. O Botão Voltar físico do dispositivo ou gestos de deslizar podem ser usados para fechar diálogos, dispensar menus ou navegar para trás, funcionando exatamente como o próprio botão de voltar do cartão. Isso é especialmente útil em dispositivos móveis. Para manter uma experiência de usuário estável, o cartão intercepta apenas ações de "voltar" e não lida com a navegação "avançar".