Instalação e Utilização

Este guia explica como colocar a Dreame Vacuum Card a funcionar no painel do Home Assistant. Abrange os pré-requisitos para a integração, os passos para adicionar a carta aos painéis existentes e instruções para configurar o recomendado Modo de Painel. O Modo de Painel proporciona a melhor experiência possível ao utilizar o ecrã completo, tornando-o especialmente potente em tablets e monitores de secretária.

---

A Dreame Vacuum Card está estreitamente integrada como parte principal do Integração Dreame Vacuum Home Assistant. Não é uma carta independente que se instala separadamente.

Para utilizar esta carta, a dreame_vacuumversão da integração v2.0.0 ou superior, que inclui a carta integrada, deve estar instalada.

Pré-requisito

Se a integração Dreame Vacuum já estiver instalada, este passo pode ser ignorado com segurança.

Se ainda não estiver instalado, a forma mais fácil de o obter é através de HACS. A integração Dreame Vacuum pode ser pesquisada em HACS > Integrações e a versão v2.0.0 ou superior pode ser descarregada. O Home Assistant deve ser reiniciado após o descarregamento. Uma vez configurada a integração, o cartão ficará automaticamente disponível nos dashboards.

Otimização de Entidades

O cartão foi concebido para operar apenas com as entidades vacuum, sensor.cleaning_history, sensor.cruising_history e camera.map. Obtém tudo o que precisa diretamente destas quatro entidades principais. Como resultado, todas as outras entidades da página do dispositivo, incluindo entidades de mapas guardados, 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 desativada e a entidade camera.map_data ativada em seu lugar. O cartão detectará automaticamente isso e exibirá todos os mapas diretamente no navegador. No mínimo, o cartão pode funcionar apenas com a entidade vacuum ativada. Embora o mapa não seja desenhado neste estado, todas as funcionalidades não relacionadas ao mapa, como configurações de limpeza, ações de doca e controlos básicos, permanecerão totalmente acessíveis e utilizáveis.

Adicionando o Cartão ao Seu Painel

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

1. Abrir o Home Assistant e navegar até o painel desejado.
2. Clicar no ícone Editar Painel () no canto superior direito.
3. Clicar no botão Adicionar Cartão () no canto inferior direito.
4. No seletor de cartões, procurar e selecionar Personalizado: Cartão de Aspirador Dreame.
5. No editor de cartões, é selecionado o Entidade Dreame Vacuum, como vacuum.l10s_gen2.
6. É clicado Salvar para adicionar o cartão ao painel.

Utilizando o Modo Painel (Recomendado)

Para a melhor experiência de utilizador, especialmente considerando o extenso editor de mapas e funcionalidades do Cartão Dreame Vacuum, é altamente recomendado utilizar o Modo Painel do Home Assistant. O Modo Painel permite que um único cartão ocupe todo o ecrã de uma vista do painel.

O cartão detecta automaticamente quando é colocado numa vista de painel e remove a sua cor de fundo e bordas exteriores para se integrar perfeitamente com o tema do painel. Além disso, todos os elementos internos da interface de utilizador estão completamente preparados para o painel e irão adaptar os seus layouts para utilizar o espaço expandido do ecrã.

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

1. O painel desejado é aberto e clica-se no ícone Editar Painel () no canto superior direito.
2. Clica-se no ícone Adicionar Vista () ao lado dos separadores da vista do painel na parte superior.
3. Na caixa de diálogo "Adicionar Vista", Painel, é selecionada a opção de cartão único no menu suspenso Layout.
4. É fornecido um Título opcional, como "Aspirador", e um Ícone, como mdi:robot-vacuum.
5. Clica-se em Guardar.
6. Clicar no botão Adicionar Cartão () no canto inferior direito.
7. No seletor de cartões, procurar e selecionar Personalizado: Cartão de Aspirador Dreame.
8. No editor de cartões, é selecionado o Entidade Dreame Vacuum, como vacuum.l10s_gen2.
9. É clicado Salvar para adicionar o cartão ao painel.

Navegação Nativa do Navegador

Quando usado no Modo Painel ou quando é o único cartão numa vista, o cartão gere nativamente a navegação do navegador. Pode-se usar o botão físico Voltar do dispositivo ou gestos de deslizar para fechar caixas de diálogo, dispensar menus ou navegar para trás, funcionando exatamente como o próprio botão de voltar do cartão. Isto é especialmente útil em dispositivos móveis. Para manter uma experiência de utilizador estável, o cartão apenas intercepta ações de "voltar" e não gere a navegação para a frente.